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This publication is for users of the V¥M/370 
Remote Spooling Communications Subsysten 
(RSCS). It describes how to: 


e Initialize the RSCS virtual machine. 
more renote 


e Start and terminate one or 
spooling sessions. 


e Handle the transmission and reception of 
spool files. 


e Issue commands to control the movement 
of spool files through the system. 


e Handle error recovery for communication 
adapters and unit record devices. 
The publication contains four parts and 
two appendixes. 


"Part 1. Introduction" 
overview of the Remote 
Communications Subsystem (RSCS). 


presents an 
Spooling 


“Part 2. Components of RSCS" contains 
the following sections: 


"RSCS Virtual Machine" discusses’ the 
initialization of the RSCS virtual 
machine, the commands available to the 


procedures the 
control the 
between VM/370 


RSCS operator, and the 
RSCS operator uses to 
movement of spool files 
users and remote stations. 


"Nonprogrammable Terminal (NPT) Line 
Driver" discusses the functions of the 
line driver that controls 


nonprogrammable remote terminals. 


"Spool MULTI-LEAVING1! (SML) Line Driver" 
discusses the functions of the line 
driver that either controls programmable 
remote stations or acts as a remote job 
entry systen to a HASP/ASP type 
processor. 
"Part 3. Nonprogrammable Renote 
Terminals" contains a section on each of 
the nonprogrammable remote terminals 
supported by RSCS. Each section covers the 
configuration of the terminal, 
establishing the line connection, terminal 
Operation, and error recovery procedures. 


"Part 4, Spool MULTI-LEAVING Remote 
Stations" contains a section on each of the 
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programmable remote stations supported by 


RSCS acting as a host, and a section on 
RSCS acting as a job entry station to a 
remote HASP/ASP batch system or its 
‘equivalent. Each section covers the 
supported configuration of the station, 
establishing the line connection, station 


operation, and error recovery procedures. 


"Appendix A: Remote Spooling 
Communications Subsystem Commands" contains 
detailed descriptions of the commands 
available to the RSCS operator. The subset 


of those commands available to the remote 
station operator is also identified. 


"Appendix B:; RSCS Message Summary" 
contains a listing of all the RSCS messages 
and responses tabulated by the command or 
function that initiated the message. A key 
to the distribution of each message or 
response is also included. 


The term "3705" or "3704/3705" refers to 


the IBM 3704, 3705, and 3705-I1 
Communications Controllers, unless 
otherwise specified. Information about the 
IBM 3705-II, the Type 4 Channel Adapter, 
and the IBM System/370 Models 135-3, 138, 
145-3, and 148 is for planning purposes 


only until the availability of the product. 
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CP Command Reference 
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RELATED PUBLICATIONS 


The operating and @rror procedures 
for the RSCS supported remote terminals and 
stations contained in Parts 3 and 4 were 
obtained from some of the following 
publications. If conflicts occur, refer to 
the latest edition of the subject document. 
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IBM 3771 and 3773 Communication 
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Component Information for the IBM 3780 Data 
GA 27-3063 


For Spool MULTI-LEAVING Stations: 


Attached 


IBM System/360 
Support 
Console 


GH20-0321 


and System/370 
Processor System (ASP) 
Manual, 


Order No. 


IBM System/360 and System/370 ASP Version 3 
Asymmetric Multiprocessing System 


en eae — > 


OS/VS1 Release 2 RES Work Station User's 
Guide, Order No. GC28-~-6879 
OS/V¥S2 HASP II Version 4 system 


OS/WS2 HASP II Version 4 Operator's Guide, 
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IBM System/3 Card 
Order No. GC21-7513 


Operator's Guide, Order No. 


al Rae, 


A 


Summary of Amendments 
for GC20-1816-1 

as updated by GN20-2694 
VM/370 Release 3 PLC 8 


NEW DEVICE SUPPORT 
New: Device Support 


The following CPUs are supported by 
SML aS remote job entry stations into 
VM/370: IBM System/370 Models 135-3, 
138, 145-3, and 148. 


The IBM 3203 Printer Model 4 is now 
supported on the System/370 Models 138 
and 148, only, as apart of, the 
configuration of HASP MULTI-LEAVING 
remote station for RSCS. 


Summary of Amendments 
for GC20-1816-1 
VK/370 Release 3 PLC 4 


IBM SYSTEM/32 SUPPORTED AS RSCS WORK IBM SYSTEM/3 MODELS 6, 8, 10, 12, AND 15 


STATION SUPPORTED AS RSCS WORK STATIONS 
New: Device Support New: Device Support 
The System/32 MULTI-LEAVING Remote Job The IBM System/3 Models 6, 8, 10, 12, 
Entry Work Station (MRJE/WS) Systen and 15, with the MULTI-LEAVING Remote 
Utility Program enables a System/32 to Job Entry Work Station (MRJE/WS) System 
function as an RJE work station for Utility Program, are now supported as 
submission of jobs to a central RSCS work stations, in addition to the 
System/370. The Systemn/32 MRJE/SWS previously supported System/3 Model 10, 
program communicates with the Remote using the RTPSYS3 workstation program. 
Spooling Communications Subsystem (RSCS) 
of VM/370 using HASP work station The section "IBM System/3 and System/32 
protocol. as Remote Stations" has been added for 


this support. 
The System/32 appears like a System/3 to 
the VM/370 host computer, and VWM/370 
actually is generated specifying the MISCELLANEOUS 
System/3 as the supported terminal. 
Changed: Documentation Only 
The work station program runs under 


control of the System/32 System Control Some technical. and editorial corrections 
Program and communicates with the VM/370 and additions have been made to improve 
system over a point-to-point (switched the clarity of this publication. 


or nonswitched) communication line via 
the Binary Synchronous Communications 
Adapter. 


ee 


In, 
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for GC20-1816-1 and GC20-1816-2 
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VM/370 Release 4 PLC 1 


MISCELLANEOUS 


Some technical and editorial corrections 
have been made to improve the accuracy 
and clarity of this publication. 
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This publication is for users of the VM/370 
Remote Spooling Communications Subsystem 
(RSCS). It describes how to: 


e Initialize the RSCS virtual machine. 
more remote 


e Start and terminate one or 
spooling sessions. 


e Handle the transmission and reception of 
spool files. 


e Issue commands to control the movement 
of spool files through the system. 


e Handle error recovery for communication 
adapters and unit record devices. 
The publication contains four parts and 
two appendixes. 


"Part 1. Introduction" presents an 
overview of the Renote Spooling 
Communications Subsystem (RSCS). 


Part 2. Components of RSCS" contains 


the following sections: 


a 


"RSCS Virtual Machine" discusses’ the 
initialization of the RSCS virtual 
machine, the commands available to the 


RSCS operator, and the 

RSCS operator uses to 
movement of spool files 
users and remote stations. 


procedures’ the 
control the 
between VM/370 


"Nonprogrammable Terminal (NPT) Line 
Driver" discusses the functions of the 
line driver that centrols 


nonprogrammable remote terminals. 


"Spool MULTI-LEAVING1 (SML) Line Driver" 
discusses the functions of the line 
driver that either controls programmable 
remote stations or acts as a remote job 
entry systen to a HASP/ASP type 
processor. 


"Part D6 Nonprogrammable Remote 
Terminals" contains a section on each of 
the nonprogrammable renote terminals 
supported by RSCS. Each section covers the 
configuration of the terminal, 
establishing the line ccnnection, terminal 
operation, and error recovery procedures. 
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“Part 4. Spool MULTI-LEAVING Renote 
Stations" contains a section on each of the 
Ercgrammable remote stations supported by 


RSCS acting as a host, and a section on 
RSCS acting as a job entry station to a 
remote HASP/ASP kEatch system or its 
equivalent. Each section covers the 
supported configuraticn of the station, 
establishing the line connection, station 


oferation, and error recovery procedures. 


"Appendix A: Remote Spooling 
Communications Subsystem Commands" contains 
detailed descriptions of the commands 
available to the RSCS oferator. The subset 
of those commands available to the remote 
station operator is also identified. 


"Appendix B: RSCS Message Summary" 
contains a listing of all the RSCS messages 
and responses tabulated by the command or 
function that initiated the message. A key 
to the distribution of each message or 
response is also included. 


The term "3705" or "3704/3705" refers to 
n 


the IBM 3704, 3705, and 3705-I1 
Communications Contrcllers, unless 
Otherwise specified. 
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RELATED PUBLICATIONS 


Note: The operating and error procedures 
for the RSCS supported remote terminals and 
stations contained in Parts 3 and 4 were 
obtained from some of the following 
publications. If conflicts occur, refer to 
the latest edition of the subject document. 


e For Nonprogrammable Terminals 


Data 


Componen IBN = 2770 Data 


IBM 3771 = and 3773 Communication 
Terminals, Order No. GA27-3100 
IBM 3774 and 3775 Communication 
Terminals, Order No. GA27-3094 
IBM 3776 Communication Terminal, Order 
No. GA27-3107 
IBM 3777 Communication Terminal, Order 
No. GA27-—3124 

IBM 2780 Data Transmission Terminal - 


Saas Sew ee ee ee ee 


e For Spool MULTI-LEAVING Stations 


IBM System/360 
Support 
Console 
GH20-0321 


and 


Operator's 


w 


TEM System/360 and System/370 ASP Version 3 
Asymmetric System 
Operator's 


Manual, Order No. GH20-1289 


User's 


Os/VS1 
Guide, 


2 RES Work Station 
GC28-6879 


Release 
Order No. 


Version 4 


system 


Os/V¥S2 HASP II Version 4 
Order No. GC27-6993 


IBN System/3 Card System Operator's Guide, 
Order No. GC21-7513 

IEM System/32 Operator's Guide, Order No. 
GC2z1-7591 

e Miscellaneous 

General Information - Binary Synchrenous 


CHANGES TO COMMANDS 


Change: Program and Documentation 


The DRAIN COMMAND, when issued for a 
link whose I/0 activity is being logged, 
will stop the logging and automatically 
initiate the printout of the log data. 
The MSG command now includes a "userid" 
operand; this allows RSCS to forward 
messages to specific VM/370 users. 


LINE DROP RECOVERY 


New: Program and Documentation 


Error recovery for nonprogrammable 
terminals that are disconnected while 
processing data has been modified to 


Summary of Amendments 
for GC20-1816-0 

as updated by GN20-2673 
VM/370 Release 3 PLC 1 


increase transmission integrity. 
Operator procedures are discussed under 
each type of terminal in "Part 3. 
Nonprogrammable Remote Terminals." 


MISCELLANEOUS 


Changed: Documentation Only 


Several technical changes have been made 
to the documentation supported devices 
and required features. 


This Technical Newsletter contains other 
technical and editorial changes brought 
to our attention by Reader's Comment 
Forms. and internal programming 
activity. 
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Part 1. Introduction 


Part 1is an introduction to the Remote 
Spooling Communications Subsystem (RSCS) as 
a component of vM/370. The following 
topics are introduced: 

e Overview of RSCS 

e The RSCS virtual machine 

e Remote stations 


e RSCS links 


e VWM/370 Spool System interface 
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Spooling Communications 
Subsystem (RSCS) is a component of VM/370. 
Together with the Control Program of 
VM/370, it controls telecommunication I/0 
devices and lines used to automatically 
transfer files between: 


The Remote 


e VH/370 users and remote stations. 


e Remote stations and other remote 


stations 


e VWM/370 users and 
batch systems. 


remote HASP/ASP type 


e Remote stations and HASP/ASP type batch 
systems. 

e Remote stations and a CMS Batch virtual 

machine. 


RSCS runs in a dedicated virtual machine 
under VM/370. This RSCS virtual machine is 
known. as the local RSCS_ station. All 
remote stations and the local RSCS station 
are assigned a i= to 8-character 
(alphameric) location identification. 


The transmission path between the RSCS 
local station and any single remote station 
is defined as a link. A link definition 
consists of a linkid (identical to the 
location identification of the remote 
station) and other information unique to 
the transmission path to be used. A table 
of these link definitions is stored in the 
RSCS virtual machine. 


VM/370 output spool files contain a 
136-byte information field called the spool 
file tag. The data in this tag field is 
inserted, changed or queried via the CP TAG 
command. In order for RSCS to control the 
transmission of spool files from a W¥M/370 
user to a remote location, the user must 
perform two functions: 


e He must "tag" the file with the location 
identifier of the remote location. 


e He must spool the file to the RSCS 
virtual machine. 
RSCS searches the table of link 


definitions for a linkid that matches the 
location identifier and uses the associated 
link definition to initiate the 
transmission. 


Overview of RSCS 


THE RSCS VIRTUAL NACHINE 


The RSCS virtual machine, running under 
VM/370, operates as any other virtual 
machine. RSCS is a single purpose operating 
system for a virtual machine, dedicated to 
processing files spocled to it, and 
transmitting these files via communication 
lines to remote stations. The 
telecommunication I/0 facilities to be 
managed by RSCS operate in binary 
synchronous mode and are attached, 
temporarily or permanently, to the RSCS 
virtual machine. See Figure 1 for a 
representative VM/370 installation using 
RSCS. 


Once RSCS has been initialized, the RSCS 
operator may disconnect his console and run 
in disconnected mode. RSCS is designed to 
operate normally without regular operator 
intervention. When disconnecting his 
console, the RSCS operator has’ the option 
of specifying another virtual machine 
console (usually the system console) to 
receive any RSCS console output. When not 
in disconnect mode, the RSCS operator can 
use the conscle to enter RSCS commands to 


alter normal file transmission and to 
monitor transmission activity. 
RSCS consists of a multitasking 


supervisor, system control tasks, and line 
driver tasks. 
multiple 


The R&SCS supervisor supports 


system control and line driver tasks that 
may be active at any one time. This 
inciudes multitask dispatching, the 


Management of virtual I/O devices used by 
RSCS, and the management of virtual storage 
required by each task. 


The system control tasks provide common 
services to the line driver tasks and 
provide communication with the RSCS 
operator. These services include command 
execution, message distribution, program 
check handling, VM/370 spool systen 
interface, and communication line 
allocation. 


Each line driver task manages the 
transmission of files to and from a single 
remote ‘station and provides a communication 
link for remote station operator commands. 
Due to functional and hardware differences 
in terminal equipment, each line driver is 
written to support a specific class of 
remote stations. 
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VM/370 


Control Program 


CP Spool File System 


CMS Batch VM/370 RSCS 
Virtual Virtual Vituial 
Machine Machine(s) : 

Machine 


ee en ee SML (RJE mode) 
---- SML (Host mode) 


Transmission Control Unit 


BiSync }| BiSync 
Line Line 


Remote 
MULTI-LEAVING 
Programmable 
Station 


Remote 


HASP or ASP 


Batch 
Processor 


Non-Programmable 
Terminal! 


Figure 1. Representative RSCS Installation 
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REMOTE STATIONS 


A remote station, in the context of RSCS, 
is any terminal or system on the other end 
of the link from the RSCS virtual machine. 
The RSCS virtual machine is also called the 
local RSCS_ station. RSCS supports two 
general types of I/O configurations used as 


remote stations: nonprogrammable and 
programable. 

Nonprogrammabie remote terminals, such 
as the IBM 2780, are I/O configtrations 
that are hard-wired to provide the line 


protocol necessary for them to function as 
remote stations. These devices are managed 
by the Nonprogrammable Terminal (NPT) line 
driver of RSCS. 


remote stations, such as 
the IBM System/3 and System/370, are IBM 
processing systems with attached binary 
synchronous communications adapters. These 
systems must be programmed to provide the 


MULTI-LEAVING line protocol necessary for 


Programmable 


their I/0 devices to function as remote 
stations. This programming support is 
provided by a Remote Terminal Processor 


(RTP) program that 1S generated according 
to HASP workstation protocol and tailored 
to the system's hardware configuration. 


remote stations like 
the System/3 can only be programmed to 
function as remote terminals. Others, like 
the System/360 and System/370, can function 
either as remote terminals or as host batch 
systems using RSCS as a remote job entry 
workstation. Both of these types of remote 
stations are managed by the Spool 
MULTI-LEAVING (SML) line driver of RSCS. 


Certain programmable 


All stations, remote and local, must be 


assigned a 1- to 8-character (alphameric) 
location identification. This 
identification usually suggests the 


physical location of the station (HOUSTON, 
DEPT14, BLDG76, ACCNING, FLOOR1 are typical 
examples). 


RSCS provides multiple concurrent line 
Management support for up to 16 remote 
stations of the various supported types. 


RSCS LINKS 


A link is defined as a potential path for 
data transmission between a RSCS virtual 
machine and a single, uniquely identified 
remote station. A group of parameters 
describing the attributes of a link is 
called a link definition. These attributes 
include the following: 


linkid - a 1- to 8-character (alphameric) 
link identifier, identical to the 
location identifier of the remote 
Station associated with the link. 


type - a 1- to 8-character (alphameric) 
name designating the module (text 
deck) name of the line driver to 


be used to Manage the 
transmission. 
line - a virtual device address of a 


telecommunication port for 
exclusive use by this link. If not 
specified, RSCS assigns the link a 


switched telecommunication port 
when the link is activated. 
class - the designation of the classes of 


files that may be processed by the 
active link. The default value of 
class is 'all classes’. 


table of link 
up at RSCS system 
This is called the RSCS 
link table. Link definitions may be 
temporarily added, deleted, or modified 
using the RSCS operator commands, DEFINE 
and DELETE. When a link is activated, the 
optional operands of the START command nay 
also be used to override the link 
attributes. (For additional information see 
DEFINE, DELETE, and START under "RSCS 
Operator Commands") RSCS supports up to 64 
link definitions; up to 16 links can be 
active at any one time. 


RSCS Maintains a 
definitions that are set 


generation time. 


WM/370 SPOOL SYSTEM INTERFACE 


All vM/370 output spool files contain a 
136-byte tag fieid located in the file's 
first spool buffer. The format and contents 
of the tag field vary according to its 
intended use. Tag information, to be 
associated with a particular spool output 
device, is entered by a VM/370 user via the 


TAG DEV command. The tag data entered via 


the TAG DEV command is stored in an area 
associated with the virtual device 
specified. When the first spool file data 
record is to be written, a tag field of 136 
blank bytes is initialized in the first 
spool buffer of the file. When a file is 
closed, the tag is accessed, tag data is 


retrieved from the storage area and 
inserted, and the tag is rewritten. 


The tag contents of a closed spool file 
can be altered only by the user on whose 
reader queue the file is chained. The 
user, usually the RSCS operator, issues the 
TAG FILE command with new tag data. 
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When the TAG command is issued by 
VM/370 user to tag a file destined 
transmission by the Remote 


Communications Subsystes, the 


data 


is 


14 


entry must be the 
identification of the remote station that 
to receive the file. For 
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description of the TAG command, see "VM/370 
User Commands" in Part 2. 


All spool files to be transmitted by 
RSCS must be spooled to the RSCS virtual 
machine hy the VWM/370 user. 


A i, 


Part 2. Components of RSCS 


Part 2 describes the three major components 
of RSCS: the RSCS control program, the 
Nonprogrammable Terminal (NPT) line driver, 
and the Spool MULTI-LEAVING (SML) line 
driver. 


The discussion of the RSCS_ contrcel 
program covers the virtual machine 
configuration, system generation, VWM/370 
user commands, RSCS operator commands, line 
drivers, RSCS messages, and system security 
and integrity. 


The descriptions of the NPT and SML line 
drivers include hardware requirements, 
supported functions, file processing, 
remote terminal operator commands, and line 
driver messages. 
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HARDWARE SUPPORTED 


The Remote Spooling Communications 
Subsystem of VM/370 supports the following 
hardware: 


e System/370 models as supported by VM/370 


e Integrated Communications Adapter(ICA) 


With Synchronous Data Adapter Type II, 
on the System/370 Model 135 
e IBM 2701 Data Adapter Unit with 


Synchronous Data Adapter Type II 


e IBM 2703 Transmission Cantrol Unit with 
Synchronous Terminal Control 

* {BM 3704 Communications Con 
emulation mode only 


ry 
ie) 
fe 
i) 
@ 
ry 
a) 
rs 


e IBM 3705 Communications Controller in 


emulation mode only 


e Remote stations as supported by the line 


drivers that run under the RSCS 
supervisor, (See the *“HardWare Products 
Supported" sections in the individual 


discussions of the NPT and SML line 


drivers.) 


RSCS VIRTUAL MACHINE CONFIGURATION 


An RSCS virtual machine is configured like 


a CMS virtual machine with a few special 
requirements and exceptions. 

It must be assigned a minimum of 512K 
bytes of virtual storage. The virtual 


storage size may be defined as large as 16 
million bytes, in multiples of 4k. 


detaches 
readers 


RSCS dynamically defines and 
virtual punches, printers, and 
whenever their use is required. 


The ECMODE option must be 
permit use cf the clock comparator 
RSCS Supervisor. 


specified to 
by the 


The RSCS virtual machine is assigned a 
5-cylinder read-only RSCS system disk 
volume to contain the RSCS nucleus, disk 


resident RSCS commands, and system library. 
RSCS supports any disk supported by CMS. 


RSCS Virtual Machine 


Although RSCS can [run without operator 
intervention, a virtual console is required 
to perform the initial program load and to 
prcvide the RSCS operator with control over 


the movement of spool files threugh the 
system. 

In order to accomplish its remcte 
spceoling functions, RSCS must be assigned a 
number of dedicated Binary Synchrenous 
Communication (BSC) lines. RSCS  sufforts 
the BSC equipped IBM 2701 and IBM 2703 
transmission contrel units, and the 
equivalent adapters of the IBM 3704 and IBM 
37¢5 programmable communications 


wode or the 
partitioned emulation 


controllers in emulation 
emulation portion of 


mode. 

Figure 2 illustrates a typical RSCS 
virtual machine configuration utilizing 
three dedicated binary synchronous lines. 

0B1 
Virtual 
TCU 


OB2 


RSCS 
Virtual Virtual 
Machine TCU 


Virtual 
TCU 


Virtual 
Console 


Figure 2. BSCS 


Typical 
Configuration 


The corresponding VM/370 directory entry 
for that RSCS virtual machine is shown in 
Figure 3. One minidisk, virtual address 


191, is defined as a read-only system disk 
for “RSCS. The last three entries define 
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three BSC lines (real 
and O7A) as being dedicated 
virtual machine with virtual 
0B1, OB2, and OB3. 


addresses 078, 079 
to the RSCS 
addresses of 


SS 
USER RSCS REMOTE 512K 

ACCOUNT 8669 

OPTION ECMODE 

CONSOLE 009 3215 

MDISK 191 2314 020 005 CMSVL1 R 
DEDICATE 0B1 078 

DEDICATE OB2 079 

DEDICATE 0B3 O7A 


Figure 3. Directory Entry for an 


Virtual Machine 


SYSTEM GENERATION OF RSCS 


The data 
Spooling 


required to generate the Remote 
Communications Subsysten is 
located on the RSCS/IPCS tape of VM/370. 
This data consists of the text files for 
all the nucleus modules, the spool file 
access method supervisor task, the line 
allocator supervisor task, and the line 
driver modules. In addition, the MACLIB, 
EXEC, and CNTRL files necessary to the 


generation procedure are also included. 
For detailed RSCS systen generation 
information, see the VM/370 Planning and 


¥M/370 USER COMMANDS 


The interface between a VM/370 user and the 
RSCS virtual machine consists of the TAG 
and SPOOL commands along with the spool 
file tag associated with every output spool 
file generated by a WM/370 user for RSCS. 


VM/370 TAG COMMAND 


The VM/370 CP TAG command is used to enter 
or query data in the spool file tag. The 
command has three functional formats: 


e Tag contents may be prespecified for all 
output files from a particular category 


of output devices or from a_ single 
output device. 
e Tag contents for an existing closed 


spool file may be replaced. 
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nee | 


with an 
closed 


e The tag contents associated 
output device contained in a 
output file may be displayed. 


The TAG command syntax is as follows: 


7 a aaa RC WE | 

TAg Printer 

DEV PUnch 
CONsole 
vaddr 


{tagtext ] 


FIle spoolid [tagtext] 
Printer 

DEv PUnch 
CONsole 


| 
| 
I 
| 
| 
| 
| 
| 
| 
| 
| vaddr 
{ 


FIle spoolid 


| 


The first operand of the TAG command 
specifies the function to be performed: 


TEV allows the user to perform the 
initialization, replacement, or 


deletion of the tag data 
associated with an output 
device. All spool files, 
generated by the device 


specified in the seccnd operand, 


will contain the tag data 
entered inthe third operand. 
If there is no third operand, 


the tag data will be blank. 


FILE allows the user to rerlace the 
entire tag data of any sfool 
file queued on his virtual 
reader and identified by the 
second operand with the new tag 
data specified in the third 
operand. If there is no third 
Operand, the tag is set to 
blanks. 

QUERY DEV allows the user to display the 
current setting of the tag 


information associated with the 
output device or device class 
specified in the third operand. 


QUERY FILE allows a user to display the tag 
information of any spool file 
queued on his virtual reader. 
The specific file in his reader 
queue is identified by the third 


operand. 
PRINTER is the syncnym for all printer 
PRI class devices. 
PUNCH is the synonym for all punch 
PCH class devices. 


CONSOLE is the synonym for all console 


class devices. 


is the virtual device address of 
a virtual unit record device or 
console. 


vaddr 


spoolid is the unique identification 
number assigned to a spool file 
by the VM/370 spooling facility. 
The numbers range from 1 to 
9900. 


tagtext is the new. or replacement tag 
data used in the TAG DEV and TAG 
FILE format of the command. The 
entire command line to the right 
of the third operand (beginning 


with the leftmost nonblank 
character to a maximum of 136 
characters) becomes’ the new 
contents of the tag for the 


specified device, device class, 
or specific file. If no text is 
specified, the contents of the 
tag are set to blanks. 
RSCS expects text to 
be as follows: 


the syntax of tag 


linkid [userid] [priority ] 


where: 

linkid is the location identifier of the 
link on which the file is to be 
transmitted. 

userid is the identification of the 


remote virtual machine that is to 
receive the file. 


requested transmission 
number 0-99, 
implying a 
with lower 


priority is the 
priority (a decimal 
defaulting to 99), 
higher priority 
numerical value. 


If userid is not applicable, as in NPT and 
SML support, and priority is to be 
specified, a dummy userid must be 
included. 

The remainder of the 136-byte tag is 
ignored by RSCS. 


TAG QUERY Command Responses: 


PRINTER 
CONSOLE 


TAG QUERY pay | eons 


Displays the contents of the tags 
associated with each device of the 
specified class as follows: 


i 
PRT { repeated for 
PUN vaddr TAG: {| each device in 
CONS | the specified 
tagtext....cecseeeeee | Class 
3 


TAG QUERY DEV vaddr 


Displays the contents of the tag associated 
with the specified device as follows: 


PRT 
PUN 
CONS 


tagtext ..ccscccace 
if tag data exists 


vaddr TAG: 


TAG NOT SET 
if the TAG command was never 
issued to that device. 


TAG QUERY FILE spoolid 


Displays the contents of the tag associated 
with the specified file as follows: 


SAQGte Xt iss sweden 
if tag data exists 


(TAG BLANK) 
if the tag is all blanks 


(TAG MISSING) 
if the file did not contain 
a tag because it was either 
an input file from the real 
card reader or was an output 
file generated before VM/370 
Release 2 PLC 11. 


V/370 SPOOL COBHAND 


RSCS must 
machine. 


to be transmitted via 
RSCS virtual 


All files 
be spooled to the 


The format of the CP SPOOL command used 
with RSCS is as follows: 
rf Sng 
| | Printer | 
| SPool | PUnch { TO] userid | 
| ] CONsole | 
| | vaddr | 
where: 
PRINTER denotes all printer class device 
PRT output. 
PUNCH denotes all punch class device 
PCH output. 
CONSOLE denotes all console class device 

output. 
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vaddr denotes all output from the 
specified virtual device 
address. 

userid is the ID of the virtual machine 


in which RSCS resides. 


Note: Other SPOOL command 
CLASS and COPY, can 


options, such as 
also be specified; see 


Users. 


RSCS USAGE OF TAG AND SPOOL COMMANDS 


To specify that all printer output is to be 
transmitted to Houston, a VM/370 user would 
enter the following commands: 


TAG DEV PRINTER HOUSTON 
SPOOL PRINTER TO NET 


where HOUSTON is the location identifier of 
the receiving station and NET is the userid 
of the RSCS virtual machine. 


If one particular output device is to 
have its output transmitted to Palo Alto 
with a priority of 10 and no userid 


specified, the VM/370 user would enter the 


following commands: 


TAG DEV OOD PALCALTO FILLER 10 
SPOOL OOD TO NET 


where OOD is the virtual output device 
address, PALOALTO is the location 
identifier of the receiving station, FILLER 
is a dummy userid entry, 10 is the priority 
value, and NET is the userid of the RSCS 
virtual machine. 


The WM/370 user may want to set up a CMS 
EXEC file to handle remote spooling 
operations. The following is a_ sample of 
such an EXEC called SEND: 


CP SPOOL &2 TO NET 

CP TAG DEV &2 &1 

62 &3 6&4 

CP SPOOL &2 OFF 
The EXEC would be invoked as follows: 

SEND PALOALTO PRINT PROG LISTING 
The EXEC executes as follows: 

CP SPOOL PRINT TO NET 

CP TAG DEV PRINT PALOALTO 

PRINT PROG LISTING 

CP SPOCL PRINT OFF 

The TAG FILE command can only be used to 

alter the tag data of a spool file in the 
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virtual reader of the user issuing the 
command. Use the CP command QUERY READER 
to obtain the spoolid of the file whose tag 
you wish to alter. This spoolid is then 
entered as the second operand of the TAG 
FILE command. 


The TAG QUERY DEV command is used bya 
vM/370 user to display the contents of the 
tag associated with the specified device or 
class of device on his virtual machine. 


The TAG QUERY FILE command is used to 
display the contents of tags associated 
with files that are enqueued on the user's 
virtual reader. It would typically. be used 
by the RSCS operator to inquire about files 
that may either have been spooled to RSCS 
by a VWM/370 user or transmitted to RSCS by 
a remote station. 


When a spool file is sent to the RSCS 
virtual machine for transmission, the spool 
file access function reads and validates 


With the file. If 
invalid destination 


the tag data associated 
the tag contains an 
linkid, the file is purged andthe file 
originator is notified cf the action. If 
the destination linkid is valid, RSCS then 
checks for an available tag slot associated 
with that linkid. If one is available, it 
is loaded with spool file information 
needed for transmission. This is done 
whether or not the linkid is active. Ifa 
tag slot for that link is not available, 
the spool file is flagged as being in a 
“pending™ status and remains so until a tag 
slot does become available. As a file 
completes transmission, the tag slot 
representing that file is released and can 
be used to queue another file for 
transmission. 


The number of tag slots assigned to each 
link is determined at system generation 
time. There is a minimum of two slots per 


link and a maximum of 512 slots for all 
links combined. The RSCS operator can use 
the RSCS DEFINE command to temporarily 
change the number of tag slots available 
for any linkid; the new value will hold 
only for the duration of the terminal 
session. Permanent changes of tag. slot 


assignments can only be made as part of the 
RSCS system generation procedure described 
in the VM/370 Planning and stem 
Generation Guide. 

Note: When a file is in a "pending" status, 
it is not recognized by the RSCS command 
processors and cannot be referenced through 
RSCS functions. However, the RSCS operator 


can use CP commands to manipulate these 
files since they are in his reader queue. 


The RSCS operator controls the functioning 
of the local RSCS facility. He can: 


e Manipulate the status, transmission 
priority, class and order of files owned 
by the RSCS virtual machine. 


e Initialize, suspend, or terminate 
transmission of files to renote 
terminals and stations. 

e Reposition or restart files currently 


being transmitted. 


e Send messages to remote terminals and 


stations. 


e Send commands to remote batch processing 
systems. 


e Query file, link or system information. 


e Monitor link activity for any remote. 
location. 

File attributes and the Parameters 
describing them in the RSCS command 
language have maximum and default values 
identical to those of the VM/370 command 
language. Because many of the RSCS 


operator commands are available to remote 
station operators, only brief descriptions 


of the commands that apply to the RSCS 
virtual machine are included in this 
section. The commands are grouped in a 
general chronological sequence as the 
operator would use them. A complete 


description of all commands, with detailed 
format, can be found in "Appendix A: Remote 


Spooling Communications Subsysten 
Commands." 

The commands available to the RSCS 
virtual machine operator fall into four 
general classifications: link and line 
control, file control, communication, and 
miscellaneous. 


LINK AND LINE CONTROL COMMANDS 


There are six commands available to the 
RSCS operator to manage the links and lines 
used for file transmission: DEFINE, DELETE, 
START, DRAIN, HOLD, and FREE. 


The DEFINE Command 


Use the DEFINE command to temporarily adda 
new link entry to the list of valid links 
(Link table) for the local RSCS 
installation, or to temporarily redefine an 
existing link definition. (Permanent link 
definitions or redefinitions can only be 
made as part of the RSCS system generation 
procedure.) The maximum number cf links 
that can be defined in the link table is 
64. A link definition, with a link 
identifier equal to the location identifier 
of a remote station, must exist in the RSCS 


link table before any transmission of 
files, to or from that remote station, can 
occur. 


The DELETE Command 


Use the DELETE command to temporarily 
delete a link definition from the RSCS link 


takle. (Permanent link deletions can only 
be made as part of the RSCS system 
generation procedure.) The link to be 


deleted must be inactive (drained or not 
started), and must have no unprocessed 
files addressed to it. Files subsequently 
addressed to a deleted or undefined link 
are purged from the systen. 


Use the START command to activate a 
particular inactive link. Certain keyword 
options may also be entered to temporarily 


override the link definition in the link 
takle. This command may be issued to an 
active link to reset a DRAIN operation 
before it has completed. If the START 


command is used to alter the class of files 
to be processed, note that "pending" files 
are not recognized for processing. 


The DRAIN Command 


Use the DRAIN command to deactivate an 
active link. If the link is currently 
processing a file, the link is deactivated 
when the current file has completed 
processing. If no file is being processed, 
the link is deactivated immediately. 


If the link is currently logging I/0 
activity, the DRAIN command will terminate 
logging and automatically print the log 
output. 
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The HOLD Command 


Use the HOLD command to temporarily suspend 
file transmission On an active link without 
deactivating it. Transmission is suspended 
at the end of the file currently being 


processed unless a keyword is entered 
Signifying that transmission is to. be 
halted immediately. In either case, 
transmission is restarted at the 
interrupted point when the FREE command is 
issued. 


Use the FREE command to resume transmission 
on a link previously in HOLD status. 


FILE CONTROL COMMANDS 


sent to the RSCS virtual 
transmission are put into the 
file queue assigned to the particular link 
to which the file is addressed. The RSCS 
operator can use three commands to control 
these files while they are waiting to be 
processed: CHANGE, ORDER and PURGE. He can 
also use three other commands to control 
files that are currently being processed: 
FLUSH, BACKSPAC, and FWDSPACE. 


Files that are 
machine for 


Note: Once a file has been transmitted into 
a network, there is no way to query for the 
location of that file in the network. 


The CHANGE Command 


Use the CHANGE command to alter one or more 
file attributes of a file owned by the RSCS 
virtual machine, engueved on some link's 
file queue, and not currently active. 


The ORDER Command 


Use the ORDER command to reorder the files 


engueued on some link's file queue. This 
redefines the order in which particular 
files are processed. A file currently 


being processed can not be reordered. 


The PURGE Command 


command to remove all or 
specified files for a link from the systen 
before they are processed. A file currently 
being processed cannot be purged. 


Use the PURGE 


to discontinue 
on a specified 


Use the FLUSH command 

processing the current file 
link. The discontinued file is either 
purged or held and link processing 
continues with the next file enqueued for 
transmission on that link. If the COPY 
attribute for the file specified multiple 
copies, only that current copy is 
discontinued unless the discontinuance of 
all copies for the file is also specified. 


The BACKSPAC Command 


Use the BACKSPAC command to restart or 
reposition, in a backward direction, the 
file currently being processed on the 


specified link. 


The FWDSPACE Command 


Use the FWDSPACE command to reposition, in 
a forward direction, the file currently 
being processed on the specified link. 


COFKEMUNICATION COMMANDS 


The RSCS operator can communicate with a 
remote station via the CMD or MSG ‘commands. 
The choice of command used depends on the 
interpretation to be given to the text 
portion of the command. 


Use the CMD command to control functions 
performed by a remote system such as a HASP 
or ASP type katch processor or to control 
the logging of line I/0 activity for a 
particular link. 
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If the text portion is interpreted as a 
remote system command, it is made available 
to the line driver for the specified link. 


The functional meaning of 


the text depends 


on the type of line driver and the nature 
of the remote station that it supports. 
For example, if the remote system is a HASP 
or ASP type processor, the text would be: 
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$ Hasp cad 
* ASp cmd 


For information on the allowable ASP and 
HASP commands, refer to the appropriate ASP 


and HASP system manuals listed in the 
Preface. 
If the text is LOG, RSCS outputs a 


printer spool file containing a one line 
record for each I/0 transaction on the 
specified link. When NOLOG is entered, or 
the DRAIN command is issued for that link, 
logging is turned off and the log output is 
automatically printed. 


The MSG Command 


—e eee er rn ee eee 


Use the MSG command to send a message (as 


opposed to a command) to a remote station 
operator. The text portion is made 
available to the line driver for the 


specified link. 


MISCELLANEOUS COMMANDS 


Three other commands are available to the 
RSCS operator: DISCONN disconnects the RSCS 


console from VM/370, QUERY obtains ~RSCS 
system status information, and TRACE 
monitors communication line activity. 

The DISCONN Command 

The DISCONN command is used by the RSCS 


operator to disconnect his console from the 
VM/370 system while RSCS continues to 
operate. An optional userid may be entered 
in the command line to specify the virtual 


machine that is to receive all RSCS 
operator console output lines. If no 
virtual machine is specified, the RSCS 


console output lines are discarded without 


being printed. 


request RSCS 
be printed on 


The QUERY command is used to 
system status information to 
the RSCS operator console. The information 
requested can be for a particular link, a 
specific file, or for the system in 
general. 


LINK INFORMATION: For a particular link, 
the operator can request status, default or 
queue information. 


Status information includes activity 
status, type of line driver, line address, 
classes of files to be processed, HOLD 
status, DRAIN status, TRACE status, number 
of files in queue and number of files 
waiting to be queued. 


Default information includes task name, 
type of line driver, line address, classes 
of files to be processed, and number of 
virtual storage file tag slots reserved for 
the specified link. 


Queue information includes the number of 
files in the queue and the number waiting 
to be entered in queve. In addition, for 
each file currently in the queue, an 
additional response is issued containing 
the spool file identification number, 
destination location, spool file class, 
current transmission priority, and the 
number of records in the file. 


FILE INFORMATION: For a specific file, the 
operator can request status information, 
RSCS-related file attributes, or 0VM/370 
spool-related attributes. 


Status information includes activity 
status and the linkid of the link on which 
the file is queued or being transmitted. 


RSCS-related attributes include 
originating location and userid, date and 
time of creation, destination location and 
userid, the link on which the file is 
enqueued, and the number of files in queue 
that precede the specified file. 


VM/370 spool-related attributes include 
transmission priority; spool file class, 
number of copies requested, HOLD status, 
distribution code, and filename and type or 
data set name. 
SYSTEM INFORMATION: The RSCS 
request a brief description of each link 
currently defined in the systen. This 
includes the link identification (linkid), 
activity status, line address, and its HOLD 
status. 


operator can 


TRACE command to monitor line 
a specified link. The trace 
message includes the total 
number of communication line transactions 
(write/read combinaticns), the number of 
communication line transactions ending with 
a line error indication, and the number of 


Use the 
activity on 
information 
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timeouts (over 3 seconds delay between 
write and read) that occurred on the line. 


Note that the TRACE command results in 
the printing of summary information about a 


link at the RSCS operator's console. The 
CMD command with the LOG operand 
(previously described) results in the 


creation of a printer spool file containing 
a detailed log of every I/0 transaction on 
a link. 


Line drivers manage the transmission of 
files between the RSCS virtual machine and 
a particular class of remote terminals or 
stations. Two line drivers are supplied 
with RSCS. One, designated as DMINPT, 
handles transmissions to and fron 
nonprogrammable terminals such as_ the IBM 
2780 and 3780; the other, designated as 
DMTSML, handles transpissions to and from 
other IBM systems operating either as 
remote programmable MULTI-LEAVING stations 


or aS HASP/ASP type host processors using 
the MULTI-LEAVING telecommunication 
protocol. 

The RSCS operator initiates a line 


driver for a particular link by issuing the 
START command. If the previously defined 
link definition is still valid, only 


START linkid 


need be specified. Should any of the link 
attributes require modification for this 
particular communication session, the START 
command with appropriate operands is used. 
For example, if the link to HOUSTON had 
been defined with a line address of 0B1 and 
a class of G, and the current session is to 
handle class S output on line address 0B3, 
the START command would look like: 


START HOUSTON CLASS S LINE 0B3 


the HOUSTON link 
output and uses the 


For this session only, 
processes only class S 
line port with virtual address 0B3. 
Non-class § output remains queued on 
Houston's link and is not transmitted until 
the class attribute is changed. 


Since more than one link can require the 
same line driver, multiple copies of a line 
driver can be active simultaneously. Each 
copy is assigned a task name at the time 
the link is defined; otherwise, an 
appropriate descriptive default task name 
is generated by RSCS when the link is 
activated. 


Once the line driver is activated by the 
RSCS operator, the link for a leased line 
is ready for the remote station to "sign 
on" with its identification and station 
characteristics. A link using a switched 
line must first complete a line connection 


by a dial-up procedure from either end of 
the link. The sign-on procedure varies by 
line driver and is covered in the 
respective line driver discussions. 

REMOTE JOB ENTRY TO CMS BATCH 

If both RSCS and CMS Batch are running 
under the same VM/370 system, a remote 


Station can submit job stream files to RSCS 
for processing on a CMS Batch Facility. 
Furthermore, by including appropriate 
commands in the job stream, CMS Batch can 
direct printer and/or punch output back to 
the originating remote stations or to 
another remote station. 


INPUT AND OUTPUT PROCEDURES 


When a remote station transmits a file to 
RSCS, destined for a CMS Batch virtual 
machine, the ID card that precedes the card 
file deck must contain the userid of the 
CMS Batch machine. If no file control 
commands are included in the job strean, 
the output of the job is directed to the 
real printer and/or punch. 


In order for a remote station to receive 
the output of a job submitted to CMS Batch, 
the job file must include appropriate SPOOL 
and TAG commands. Output devices must be 
spooled to the RSCS virtual machine. Spool 
files generated on the spooled devices must 
be tagged with the linkid of the remote 
station that is to receive the output. 


For example, if a job file with printer 
output is sent from a remote station with a 
linkid of HOUSTON and the output is to be 
returned to the same station, the following 
commands and control cards are required: 


ID CMSBATCH 
/JOB RSCS HOUSTON PAYROLL [comments ] 


SPOOL PRINTER TO RSCS 
TAG DEV PRINTER HOUSTON 


AEE an, 


The userid and jobname (RSCS and PAYROLL) 
is the distribution data printed on the 
separator sheet of the output printed at 
the remote station. 


JOB ACCOUNTING CONSIDERATIONS 


The accounting routines in the vVM/370 
Control Program distribute system resource 
usage by the userid and account number 
specified in the /JOB card. in the 


preceding example, charges are distributed 


by the account number within the RSCS 
userid. If the account number is specified 
as the linkid of the originating remote 
station, system resources are charged 


directly to the remote station. 


If system resource accounting is desired 
at a lower level, for example an individual 
job, the /JOB card can be specified as 
follows: 


“JOB HOUSTON PAYROLL PAYROLL [comments] 


In this example, charges are distributed 
to the PAYROLL job for the HOUSTON link. 
The userid and jobname (HOUSTON and 
PAYROLL) appears on the separator sheet of 
the output printed at the remote terminal. 


Note, however, that in order to use 
HOUSTON as a userid, it must appear in the 
WVM/370 directory. This can be accomplished 
by the system programmer entering HOUSTON 
as a NOLOG user in the directory. 


RSCS MESSAGES 


issued in response to 

system execution. The 
response message is delivered to the 
associated command originator, generally 
the RSCS local or remote operator, or both, 
depending on the availability of the remote 


RSCS messages are 
commands, and during 


station printer to serve as an operator 
console output medium. When RSCS is 
operating disconnected, unsolicited 
messages are issued to another virtual 
machine console or to the WM/370 operator 
conscle by means of the VM/370 MESSAGE 


command, if it is so specified in the 
DISCONN command. If this function is not 
specified, these messages are discarded. 


Certain unsolicited messages are issued 
to virtual machine users via the VM/370 
MESSAGE command when the message pertains 
to a file originated by or destined for the 
user. 


A listing of all RSCS messages, 
unsolicited or in response to commands, can 
be found in “Appendix B. RSCS Message 
Summary." For a detailed listing and 
description of all RSCS messages, see 
VM7370 System Messages. 

The message codes listed conform to 
WM/370 standards. The origin of each 
message is encoded as the fourth, fifth, 
and sixth character of each message code. 
The possible codes are REX, CMX, AXS, INI, 
and xxx, where xxx is replaced with the 
code of the particular line driver module 
which is issuing the message: NPT, for the 
Nonprogrammable Terminal Line Driver, and 


SML for the Spool MULTI-LEAVING Line 
Driver. Printing of the ten-character 
message codes may be suppressed by the 
local RSCS operator by use of the SET EMSG 
command. 


RSCS utilizes the Diagnose function of 
CP to handle console functions such as 
DEFINE and DETACH. The frequency of use of 


these commands by  RkSCS results in an 
excessive number of confirming messages 
being printed on the operator's console. 


issue the CP command 
suppress these 


The RSCS operator can 
SET ISG OFF to 
informational messages. 


In the event of an unrecoverable error, 
RSCS enters a disabled wait state. If 
either the DMTREXO90T or DMTREXO091T message 
is displayed on the RSCS operator's 
console, an automatic virtual storage dump 
is also taken. Otherwise, the CP DUMP 
command should be issued. 


TRACING FACILITIES 


RSCS provides the RSCS operator with two 
methods of monitoring line activity on the 
system: the TRACE command and the LOG|NOLOG 
option of the CMD command. 


TRACE COMMAND 


The TRACE command 
operator with a periodic summary of a 
link's line activity, printed on the RSCS 
operator's console. The information 
consists of three counts, accumulated 
during the recording period: total line 
transactions, line transactions ending in a 


provides the RSCS 


line error condition, and timeouts while 
waiting for a response from the other 
station. 
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The frequency of TRACE messages depends 
on predefined thresholds that vary 
according to the type of line driver. For 
the NPT line driver, the threshold value is 


20; for the SML line driver, it is 60. If 
the ALL operand of the TRACE command is 
specified, the TRACE message is issued 


whenever the count of total transactions or 
the count of timeouts on the line reaches 
the threshold value. If the ERRORS operand 
is specified, the TRACE message is issued 
whenever the count of line errors reaches 
the threshold value. The line statistics 
are reset after each TRACE message. 


I/O LOGGING 


The LOG operand of the CMD command provides 


the RSCS operator with a log of all I/0 
transactions that occur on ae_ée specified 
link. The logging output is a printer 


spool file containing a one-line record for 
each I/O transaction on the teleprocessing 
line. A transaction is defined as each 
time a teleprocessing buffer is sent or 
received. 


Each NPT and SML log record contains: 


e Selected teleprocessing buffer contents 
e CSW information 


e The sense byte 


e The CCW associated with the Iso 
operation 
In addition, the SML log record 


contains: 


e The first three bytes of the RSCS synch 
lock for this operation. 


of various 
"Logging I/0 


For the 
log records, 


format and examples 
see the section 


Activity" in Part 5 of the VWM/370 System 
Programmer's Guide. 
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When logging is turned off via the NOLOG 
operand or the DRAIN command, the output is 
automatically printed with a distribution 
code equal to the linkid that was specified 
on the CMD command. 


SYSTEM SECURITY AND INTEGRITY 


The security of the Remote Spooling 
Communications Subsystem is provided by CP, 
the control program component of VM/370. CP 
ensures that all virtual machines operating 
under VM/370 are isolated from one another. 
RSCS can only be accessed by those persons 
authorized by the installation manager. 
Also, the RSCS supervisor does not execute 
user programs. 


The integrity of user data is provided, 
in part, by the recovery and restart 
capabilities of VM/370. Since RSCS utilizes 
the VM/370 spool system as a hold area for 
files to be transmitted, the warm start and 
checkpoint start facilities of VM/370 also 


apply to RSCS. After a warm or checkpoint 
start, the RSCS file manager provides, to 
the line drivers, the functions necessary 


to restart transmission 
files that were active on the link and not 
yet closed at the time of the system 
failure that caused the restart. Processing 
is resumed at the point in the file where 
previous processing was interrupted. 


and reception of 


The accountability for files transmitted 
by RSCS rests with independent end-to-end 
acknowledgement procedures that should be 
established between source and destination 
locations. If the user feels that the 
integrity of the system is insufficient for 
his particular situation, he should store 
his files on disk before transmitting 
them. Files should not be purged until the 
operator or the the user has confirmed that 
the files have arrived at their 
destination. 


<i a, 
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Nonprogrammable Terminal (NPT) Line Driver 


The NPT line driver, operating as a task 
under the RSCS component of VM/370, 
provides VM/370 with support of binary 
synchronous communication (BSC) line 
protocol for nonprogrammable remote 
terminals. This allcws: 


* Remote users of ¥M/370 to enter source 
decks, data, and jobs, on cards, into 
the VM/370 spool systen. 


e VM/370 to send spcoled output of virtual 
machine sessions to remote card punches 
and printers. 

e Remote RSCS stations to transmit card 

decks to one another. 


e Remote stations to send job streams to a 


CMS Batch virtual machine operating 
under the same VH4/370 and have the 
output returned to the remote station. 


HARDWARE PRODUCTS SUPPORTED 


== SS ee Se ee a se ee 


The following devices are supported by the 
NPT line driver as remote nonprogrammable 
terminals: 


e IBM 2770 Data Communication System with 
the 2772 Multipurpose Control Unit 


e IBM 2780 Data Transmission Terminal, 
Modeis 1 and 2 

e IBM 3770 Data Communication System 
(nonprogrammable models) operating in 


2770 BSC mode 


e IBM 3780 Data Communications Terminal 


1. The 3770 is supported only when its 
communication line terminates in an 
Integrated Communications Adapter 
(ICA) on the System/370 Model 135, an 
IBM 2701, or an IBM 3704/3705 
Communications Controller. 


2. The 3770 keyboard is not’ supported; 
however, by using the IRS character, 
the 3770 keyboard may be used to 
Simulate a card reader. 


3. Define the 3770 and 3780 as 2770s. 


SUPPORTED FUNCTIONS 


a line driver task 
the control of the RSCS 

NPT task can drive one remote 
nonprogrammable station. In other words, 
each NPT task controls a Single 
point-to-point communications line. The 
task is started by the RSCS' cperator, 
identified with a destination name, and 
provided with a leased or switched 
telephone line. The communications line is 
identified either by the operator or 
derived from a table entry within RSCS. 
The line is then activated and the type of 
remote station and its configuration 
details are obtained from the SIGNON 
control card entered at the remote station, 
or from a table entry within RSCS. 


NPT is operating under 


supervisor. Each 


Once this initialization is 
accomplished, the terminal may then be used 
to submit files via the card reader and 
receive files on the punch and printer. 
The remote station operator can control 
input/output activity via control cards and 
standard station procedures. The RSCS 
operator controls the operation With 
interactive commands from his console. The 
virtual machine user retrieves files sent 
to his virtual machine by using normal 
virtual card reader management programs and 
directs output to the appropriate station 
using the SPOOL and TAG commands of VM/370. 


variations of the 
basic BSC protocol for each of the staticns 
listed. The protocol is based upon the 
station identificaticn information located 
in an RSCS takle or SIGNON card accessed at 
initialization time. NPT functions are 
further described as follows: 


NPT operates with 


° RSCS operator functions 

° Remote terminal operator functions 

° Virtual machine user functions 

e Input/output control 

e Line allocation 

RSCS OPERATOR PUNCTICNS 

The RSCS operator controls the initiation 
and termination of the NPT task. He can 
control the spool files enqueued upon the 
RSCS virtual machine in much the same way 
as the VM/370 Operator centrols the 
speoling function of VM/370. In addition, 


he can send and receive messages to and 
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from the remote terminals controlled by 
NPT. Activity on the communications line 
controlled by NPT is logged on the RSCS 
operator's console. 
REMOTE TERMINAL OPERATOR FUNCTIONS 
The remote terminal operator can: 

1. Issue commands to NPT to affect 

changes in the operation of his 


terminal. 


2. Provide a batch service, transmitting 


jobs to and receiving output from a 
batch virtual machine such as CMS 
BATCH. 

3. Transmit and receive card decks 
through NPT, to and from another 
terminal supported by RSCS and 


attached to the same VM/370 system. 


VIRTUAL MACHINE USER FUNCTIONS 


The virtual machine user can: 


1. Route the output of his virtual unit 


record devices to a remote 
nonprogrammable terminal. 
2. Have a card deck entered at a remote 


nonprogrammable terminal and have it 
queued on his virtual machine reader. 


INPUT/OUTPUT CONTROL 


NPT uses the RSCS supervisor I/0 services 
to perform input/output operations on the 
BSC line to the remote terminal and to 
control the virtual,reader and punch. NPT 
uses the RSCS supervisor console support 
facility to write messages to and receive 


commands and information from the RSCS 
operator. 
NPT communications I/O comprises five 
separate operations: 
1. Control of the line when the task is 
idle. When NPT reads the 


telecommunications control unit with a 
three second timeout, the timeout is 
used to force periodic checking for 
the arrival of spool files to send. 


2. Transmission procedure for 
files to the remote station. 


sending 


3. The procedure for receiving files fron 
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the remote station. 


4. Error analysis and recovery while 
transmitting to the remote station. 


5. Error analysis and recovery while 


receiving from the remote station. 


All input/output operations are executed 
following the 270x BSC protocol for the 


type, configuration, and features of the 
remote terminal as determined at task 
initialization time. To the extent that 
the remote terminal hardware is capable of 
it, long output files may be interrrupted 
to allow the card input of data or 
commands. When the input transmission is 


completed, output transmission 
resumed from the point of 
For certain terminal types, 
3780, output lines that 
when printing 
will be lost. 


is normally 
interruption. 
such as. the 
were in the buffer 
or punching was interrupted 


Transmission to a remote punch device is 
performed in transparency mode, if the 
transparency feature is available, while 
transmission to a remote printer is always 
performed in nontransparency mode with 
elimination of trailing blanks in each 
record. Print files are always translated 
in order to eliminate invalid characters 
that would force a transparent wait state 
on a teleprocessing control unit in 
nontransparency mode. 


LINE ALLOCATION 


The Line Allocator in the RSCS supervisor 
allocates an available line to NPT as part 
of the execution of the RSCS START command. 
The line has either been designated in the 
START command, found in the RSCS' link 
takle, or selected by the Line Allocator 
from a pool of switched lines set up at 
system generation of RSCS. When the NPT 
task requests termination, the RSCS 
supervisor automatically indicates that the 
line can ke reassigned, effectively 
deallocating it. It is selected from the 
tatle of available lines by the allocator 
the next time a line is requested. 


STARTING NPT 


Fefore a remote terminal can sign on to 
NPI, the appropriate task for that link 
must have teen started by the RSCS 
operator. An example cf the START command 
for NPT and the variables to be specified 
is as follows: 
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linkid[ TYPE DMTNPT][ LINE vaddr]! 
| ({Parm passwd] 
| | 


is the location identifier of the 
remote terminal that NPT is to 
cOmmunicate with. 


is the name of the line driver to 
be used with the newly activated 
link. This specification 
overrides the driver name that 
may have been previously defined 
for the link. If no driver was 
previously defined for the link, 
this field must be specified. 


DMTNPT 


vaddr is the virtual address of the 
communications line. (vaddr is 
used only if the line is to be 
other thai one previcusly 
specified in the link 
definition.) 
passwd is an opticnal operand of one to 
eight Characters which, if 
entered, designates a password 
that the remote station must 
SUPPLY to be allowed to connect 
to the RSCS system. If a 
Password is not supplied in the 
START command or in the RSCS link 
table, the remote station is not 
required to supply a password at 
sign-on time. 


full description of the START 
refer to "Appendix A: Remote 
Communications Subsysten 


For a 
command, 
Spooling 
Commands." 


SIGNING ON TO NPT 


See eee ee eee 


has initialized the 
task, contact may be 
a switched line by dialing 
the other location from either end of the 
link. If the line specified is a leased 
line, or if the above contact procedure has 
been successfully accomplished, a SIGNON 
card must then be entered as the only card 
from the card Treader at the remote 
terminal. After the signon message has 
been received at the remote terminal, the 
remote terminal operator may then enter 
other commands and data cards. The signon 
card is usually used only once in a 
session. In the event of a line drop, the 


Once the operator 
appropriate NPT 
estaklished on 
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reentered via the card 
reader in order to restart the line. The 
SIGNON card is used to designate the type 
of terminal, the features it has, and other 
information as described below: 


SIGNON card must ke 


ess 
| SIGNON | linkid type[BnnnJ[CMPR][Pnnn]} | 
| [{TRSx ]{ PCHx ][ LPRT I{[ PWD=passwa ]| 


where: 


linkid is the location identifier of the 
remote terminal signing on to 
NPT. If this does not match the 
NPT task linkid of the START 
command, the SIGNON card is not 
accepted. 


indicates the terminal type and 
must be 2770, 2780, 3770 or 3780. 


type 


line buffer 
of the number 


specifies the 
extension in terms 
ef bytes {nnn} and may be: 128, 
256, or 512 for the 2770; 170 or 
400 for the 2780; 256 for the 
3770; and 512 for the 3780. The 
defaults are: 


Enna 


Default 


Terminal 


3770 
3780 


B256 
B512 


CMER specifies that the blank 
compression feature is present on 


the 2770, 3770, and 3780. 


specifies the number cf print 
positions available at the remote 
printer. nnn may be 1206, 132 or 
144. The default value is P120 
for the 2770, 2780 and 3780; it 
is P132 for the 3770. 


Pnnn 


TRSx is entered as TRSY (YES) if the 
remote terminal has the 
transparency feature and TRSN 
(NO) if it does not have the 
transparency feature. The 


default is TRSN. 


PCHX is entered as PCHY 
punch is available 
terminal and PCHN 
punch is available. 
is PCHN. 


(YFS) if a 
at the remote 
(NO) if no 
The default 


LPRT specifies that all print output, 
including messages, is to be 
directed to the line printer. 
This keyword is only valid when a 


terminal type of 3770 has’ been 
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specified. If this keyword is 
omitted, the default print device 
is the console printer. 


PWD=passwd 
is a password that must match the 
Password entered by the operator 
in the START command or contained 
in a link definition table owned 
by RSCS. If no password was 
entered in the START command or 
contained in the RSCS link table, 
this operand is not required. 
The keyword, PWD=, is required if 
passwd is entered; a space may be 


inserted between the equal sign 
and the password. 
INPUT FILE PROCESSING 
The remote terminal submits input to the 
RSCS machine via the remote card reader. 
This input can be directed to the virtual 
reader of a VM/370 user or to another 


remote terminal or station. 


A control card is placed in front of the 
deck to be sent fron the remote terminal to 
the virtual machine card reader of a user 
or to another remote station. The format 
of this card is as follows: 


col 1 10 
he te YS eae PE PST Sw EN NT pew ee eS feo rama 
userid {[tagtext] | 


where: 

userid is the userid of a virtual 
machine to receive the card deck 
that follows. 

tagtext is an optional string of operands 


ceonsistent with the use of the 


spool file tag field by RSCS. 


If userid is the ID of the RSCS virtual 
machine, and if tagtext contains a valid 
RSCS linkid, RSCS transmits the input file 
to another remote terminal or station. 


Note: If it 
3770) to 
keyboard, 


is possible (as on the IBM 
enter the ID card data from a 
upper case notation must be used. 


If the userid on the ID card is invalid, 
RSCS spools the punch file to the real 
punch and the originator is not informed. 
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QUIPUT FILE PROCESSING 


files are transmitted 
terminal, a header line is 


When print and punch 
to a remote 


created on the output to identify the 
Originating userid, date, and time of 
transmission. Card decks punched at the 


remote terminal contain the source header 
information on the first card punched; the 
rest of the card is filled with asterisks. 
Printer files use a carriage control tape 
with channel 1 signifying the first print 


line. 
In addition to header information, 
printer files are separated from one 


ancther by header pages which may be seen 
by the operator, at the edge of the unburst 
Paper, to allow the operator to separate 
printed output. The format of the 
separator page is as follows: 


- Page eject 

- Skip 61 lines 

- 5 lines of n asterisks per line 
- 1 line of n underscores 

- 5 lines of n asterisks per line 
~ 2 blank lines 

- The source header line 

- Page eject 

- The print file. 


where n is 120 or the number 
positions available on 
whichever is less. 


of printable 
the remote printer, 


The card and print file header 

information is as follows: 
Col Field Meaning 

1 PALELIIT File origin location 
13 VAVOVEVM File origin virtual 

machine 

Zs mn/dd/yy File origin date 
37 hh:mm:ss File origin time 


phe) WAS THE ORIGIN 


REMOTE TERMINAL OPERATOR COMMANDS 


The remote terminal cperator is allowed to 
use a sukset of the RSCS commands. The 
commands are punched on cards, beginning in 
column 1, one per card, and are read cn the 


remote card reader. Command cards must 
precede the ID control card for an input 
file. In general, the remote operator can 
issue commands that affect only his 
specific link. The commands are described 
below, by functional grouping. A complete 
description of all commands, with detailed 
format, can te found in “Appendix A. 
Remote Spooling Communications Subsystem 


Commands." 


With the exception of the MSG 
command, the linkid operand is not to be 
entered by a remote terminal operator when 
submitting commands to RSCS. 


Note: 


LINK AND LINE CONTROL COMMANDS 


Use the DRAIN command to deactivate your 
link. If the link is currently processing 
a file, the link is deactivated as soon as 
the current file is processed. If no file 
is being processed, the link is deactivated 
immediately. 


If the link is currently logging I/0 
activity, the DRAIN command will terminate 
logging and automatically print the log 
output. 


The HOLD Command 


Use the HOLD command to temporarily suspend 
file transmission on your link without 
deactivating it. Transmission is suspended 
at the end of the file currently being 


processed unless a keyword is entered 
Signifying that transmission is to be 
halted immediately. In either case, 
transmission is restarted at the 
interrupted point when the FREE command is 
issued. 


Use the FREE command to resume transmission 
on your link, previously in HOLD status. 


FILE CONTROL COMMANDS 


The CHANGE Command 


Use the CHANGE command to alter one or more 
file attributes of a file enqueved on your 
link's file queue, and not currently 
active. 


Use the ORDER command to reorder the files 


enqueued on your link's file queue. This 
redefines the order in which particular 
files are processed. A file currently 


being processed can not be reordered. 


Use the PURGE command to remove all or 
specified files, enqueuved on your link's 
file queue, from the system before they are 


processed. A file currently being 
processed cannot be purged. 

The FLUSH Command 

Use the FLUSH command to discontinue 


processing the current file on your link. 
The discontinued file is either purged or 
held, and processing continues with the 


next file enqueued for transmission on your 


link. If the COPY attribute for the file 
specified multiple copies, only that copy 
currently being processed is flushed, 


unless you also specify that all copies of 
the current file be flushed. 


The BACKSPAC Command 


Use the BACKSPAC command to restart or 
reposition, ina backward direction, the 
file currently being processed on your 


link. 


Use the FWDSPACE command to reposition in a 
forward direction, the file currently being 
processed on your link. 


The START Command (for an active link) 


Use the START command to change the classes 
of files that are processed on your jiink or 
to reset a DRAIN operation before i: has 
completed. 
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COMMUNICATIONS COMMANDS 


The MSG Command 


Use the MSG command to send a_ message to 
the RSCS operator, a local VM/370 user, or 
to another remote station or terminal. 
MISCELLANEOUS COMMANDS 

The QUERY Command 

Use the QUERY command to request RSCS 


system status information for a particular 
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‘A subset 


link, a specific file, 
general. 


or for the system in 


NPT MESSAGES 


of the RSCS operator messages is 
printed on the remote terminal printer. Due 
to the unavailability of a separate console 
printer for messages, and the resulting 
confusion which would ensue if messages 
were mixed with printer output, DMTNPT 
provides for a mesSage queue. Whenever the 
remote printer has completed processing an 
output file, the messages that have been 
queued, since the last message was printed, 
are transmitted and printed. Refer to 
"Appendix B: RSCS Message Summary" for a 
key to the distributicn of messages. 


aim. 


a, 


used to describe a 
used by the SML 


MULTI-LEAVING is a term 
communication technique 
line driver operating under RSCS. 
Basically, physical records that are input 
to MULTI-LEAVING are reduced to a series of 
character strings of two basic types: a 
variable length nonidentical series of 
characters, and a variable number of 
identical characters. The segmentation of 


physical records into these character 
strings takes advantage of identical 
character compression. Multiple physical 
records (now in the form of character 
strings) are grouped into a Single 
transmission block. The MULTI-LEAVING 
design provides for a bidirectional 
interleaved exchange of transmission 
blocks, each containing multiple data 
streams. For a detailed description of 
MULTI-LEAVING see "Appendix Bs 
MULTI-LEAVING" in the VM/370 System 


The SML line driver, operating as a task 


under the RSCS component of V4 /370, 
provides VM/370 with support of 
MULTI-LEAVING, binary synchronous 
communications (BSC) line protocol for 
programmable remote stations. This enables: 
e VWM/370 users to have remote job entry 

access to HASP/ASP-type batch 


processors. 


submit source decks, 
cards, into the 


e Remote stations to 
data, and jobs, on 
VM/370 spool system. 


© VM/370 to send spooled output of virtual 
machine sessions to remote card punches 
and printers. 


e Transmission of card decks between two 
remote stations supported by RSCS. 


e Remote stations to send job streams to a 
CMS Batch virtual machine (operating 
under the same VWM/370 as RSCS) and have 
the output returned to the originating 
or other remote station. 


submit source decks, 
cards, to another 
HASP or ASP 


e Remote stations to 
data, and jobs, on 
remote location running a 
type batch processor. 


Throughout this manual the term HASP/ASP 
refers to the following systems: 


HASP II Version 3.1 (360D-05.1.014) 
HASP II Version 4 (370H-TX-001) 
ASP Version 3.1 (360A-CX-15X) 


Spool MULTI-LEAVING (SML) Line Driver 


JES2 Component of VS2 Release 2 

JES3 Component of VS2 

RES Component of VS1 Release 2 and 
above 


The following systems are supported by SML 
as remote job entry stations into VM/370: 


IBM System/360 Models 20, 22, 25, 30, 
40, 50, 65, 75, 85, 195 


IBM System 370 Models 115, 125, 135, 
135-3, 138, 145, 145-3, 148, 155, 
155 II, 158, 165, 165 II, and 168 


IBM 1130 System 

IBM System 3 Models 6, 8, 10, 12, and 
15 

IBM 2922 Programmable Terminal 

IBM Systemn/32 


When SML is operating as a remote job 
entry access system to a HASP/ASP-type 
processor, it communicates with any IBM 
system that supports the HASP/ASP 


MULTI-LEAVING transmission protocol. 


SUPPORTED FUNCTIONS 


The SML line driver, 
control of the RSCS supervisor, functions 
in one of two modes, specified at the time 
the line driver task is initialized: 


operating under the 


RJE Mode: where SML functions as a_ job 
entry workstation to a remote HASP/ASP-type 
processor. 


HOST Mode: where SML functions as the host 
to a remote MULTI-LEAVING programmable 
station. 

Each SML task controls a single 
communication line, or link. The task is 
started by the RSCS operator, identified 
with a destination name, and provided with 
a leased or switched telephone line. The 
communication line is identified either by 
the RSCS operator in the START command or 
derived from a table entry in RSCS. Ona 
switched line, a dial-up procedure from 
either end of the line establishes the 
connection. 


a slightly modified 
whether it is 
In RJE mode, 


SML operates with 
protocol depending on 
operating in RJE or HOST mode. 
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the type of remote host systen, as 
designated in the START command, determines 
the protocol to be followed. In HOST mode, 
SML follows a common protocol for all 
remote stations. The functional support is 
described below in the following 
categories: 


RSCS operator functions 

Remote station operator functions 
Virtual machine user functions 
Input/output control 

Line allocation 


RSCS OPERATOR FUNCTIONS 


The RSCS operator controls the 
initialization and termination of the SML 
task. He controls the spool files enqueued 
on his virtual reader in much the same way 
as the VM/370 system operator controls the 
spooling functions of VWM/370. He can send 
Or receive messages to and from the remote 
stations controlled by SML. Using the 
TRACE command, he can monitor the activity 
on the communications line and have that 
data logged on his operator console. 


If SML is in RJE mode, the RSCS operator 


can use the CMD command to send any 
allowable workstation commands to the 
remote host system that is processing the 
data. 


REMOTE OPERATOR FUNCTIONS 


If the remote station is a HASP/ASP system 
(SML in RJE_ mode) its functions with 
respect to SML are the same as’ they would 
be for any other HASP/ASP remote 
workstation. It accepts job streams for 
batch processing or commands affecting the 
processing from SML and directs job output, 
in punch or printer format, back to SML. 


When SML is in HOST mode, the remote 


station operator has the ability to: 


® Issue commands to SHL to affect changes 

in the operation of his remote station. 
© Provide a batch service, transmitting 
jobs to and receiving output from a 
batch virtual machine (OS, CMS BATCH, 
VM/370). 
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e Transmit and receive 
SML to and from another remote station 
supported by RSCS and attached to the 
same VM/370 systen. 


card decks through 


VIRTUAL MACHINE USER FUNCTIONS 


When SML is in RJE mode, the VM/370 user 
can submit job streams to a remote HASP/ASP 


type batch system. Punch and/or printer 
output, returned to SML, is directed to the 
real printer and punch. 

When SML is in HOST mode, the VM/370 
user can route the output of his virtual 
unit record devices to a remote 
MULTI-LEAVING programmable station. He can 
also have a card deck entered at a remote 


station and have it enqueuved on his virtual 
machine reader. 


INPUT/OUTPUT CONTROL 


SML uses the RSCS supervisor I/O services 
to perform input/output operations on the 
BSC line to the remote terminal and to 


control the virtual reader and punch. SML 


uses the RSCS supervisor console support 
facility to write messages to and receive 
commands and information from the RSCS 
operator. 
SHL communications I/O comprises five 
separate operations: 
1. Control of the line when the task is 
idle. When SML reads the 


telecommunications control unit with a 
three second timeout, the timeout is 
used to force periodic checking for 
the arrival of spool files to send. 


2. Transmission procedure for 
files to the remote station. 


sending 
3. The procedure for receiving files from 
the remote station. 


4. Error analysis and recovery while 
transmitting to the remote station. 


5. Error analysis and recovery while 
receiving from the remote station. 


All input/output operations are executed 


following the 270x BSC protocol for the 
type, configuration, and features of the 
remote station as determined at task 
initialization time. Long output files may 
be interrupted to allow the card input of 
data or commands. When the input 
transmission is completed, output 


A He, 


transmission is 
point of interruption; 
procedure will be covered in 

on the individual terminals. 

to a remote punch device is 

transparency mode. Printer 
always translated in order to eliminate 
invalid characters which would force a 
transparent wait state on a teleprocessing 
control unit in nontransparency mode. 


normally resumed from the 
deviations from this 
the sections 
Transmission 
performed in 

files are 


LINE ALLOCATION 


The Line Allocator in the RSCS supervisor 
allocates an appropriate line to SML during 
execution of the RSCS START command. The 
line has either been designated by the 
operator in the START command, found in the 
RSCS link table that contains the valid 
link definitions, or selected by the Line 
Allocator from a pool of switched lines set 
up at RSCS system generation. When the SML 
task requests termination, the RSCS 

upervisor automatically indicates that the 
line can ke reassigned, effectively 
deallocating it. It is selected from the 
table of available lines by the allocator 
the next time a line is requested. 


Before a remote station can sign on to SML, 
the appropriate task for that link must 
have been started by the RSCS operator. An 
example of the START command for SML and 


the variables to be specified is as 
follows: 
| om el copa ge Oe TD GE ee DE ee 
| STArt j linkid[TYPE DASTSML]{LINE vaddr]! 
| | Hrn | 
| | Rrn r a | 
| | Parm \Arn([{Bnnnn}|password| | 
| | Mrn Juser/pwd| | 
| H . + | 
nh a i ea Jj 
where: 
linkid is the location identifier of the 
remote station that is to 
communicate with SML. 
DMTSML is the name of the line driver to 


be used with 
link. This 
overrides the driver name which 
may have been previously defined 
for the link. If no driver was 
previously defined for the link, 
this field must be specified. 


the newly activated 
specification 


vaddr 


Rrn 


Arn 


Mrn 


Bnnnn 


password 
user/pwd 


the 
(vaddr is 


is the virtual address of 
communications line. 
used only if the line is to be 
other than one previously 
specified in a link definition.) 


indicates that SML operates as a 
remote job entry system into a 
remote HASP or JES2 system as 
remote number rn. 


indicates that SML operates as a 
remote job entry station into the 
Remote Entry Subsystem (RES) of 
VS1 Release 2 as remote number 
rm. 


indicates that SML 
remote job entry 
remote ASP or 
remote name rn. 


operates as a 
system into a 
JES3 system as 


indicate that SML operates as 
host to a remote programmable 
station signing on as remote 


number rn. 


indicates the telecommunication 
buffer size. The maximum value 
that can be specified in nnnn is 
1017. If the operand is omitted, 
the buffer size defaults to 400. 
If the optional password operand 


is specified, the buffer size 
must be entered. 
is an opticnal operand, used by 


driver to 
of a terminal 


the DMTSML line 
validate the start 
session as fcllows: 


e In RJE mode, the specified 
identification is passed along 
to the remote system as part 
of the SIGNON record. If the 
remote system is HASP, ASP, or 
JES, identification consists 
of a 1- to 8-character 
password. If the remote 
system is RES, identification 
consists of a 1 to 8-character 


userid followed by a= slash 
character followed by a 1- to 
8-character password for a 


Maximum of 17 characters. 


e In HOST 
identification 


mode, the 
consists of a 
1- to 8-character password 
that the remote station must 
supply on its SIGNON card in 
order to ccnnrect to RSCS. If 
no password is entered on the 
START command, none will be 
required from the remote 
station. 
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For a full description of the START 
command, see "Appendix A: Remote Spooling 
Communications Subsystem Commands." 


If the operator has initialized the 
appropriate SML task, contact Bay be 
established by dialing the other location 
from either end of the link. If the line 
specified is a leased line, or if the above 
contact procedure has been successfully 
accomplished, the sign-on procedure is then 
executed. 


SIGNING ON IN RJE MODE 


If SML is operating in 
task signs on to the remote HASP/ASP 
system. Using information from the START 
command and standard HASP/ASP protocol, SML 
builds a SIGNON record and submits it to 
the remote system. When the remote system 
accepts the SIGNON record, SML is notified 
and communication on the link is 
initiated. 


RJE mode, the SML 


SIGNING ON IN HOST MODE 


Se ee ee ee 


If SML is operating in HOST mode, the 
remote station must submit the sign-on 
information. Since remote programmable 
stations are loaded with Remote Terminal 
Processor (RTP) programs in order to 
communicate with RSCS, the SML SIGNON card 


or its equivalent is included in the 
program deck. A password for system 
security may also be included. The format 
of the SIGNON card is as follows: 
Col 1 16 25 
ee ae ee ee Pa ard ate ee pe ee ee 
| /*SIGNON REMOTErn password | 
| Scr nT ee | 
The value of rn following the keyword 
REMOTE must match the terminal number 
specified in the Mrn operand of the START 
command. 


A password is required only if the START 
command specified a password operand, or if 
a password was part of the link definition 


in the RSCS link table. If the password 
option is in effect, the password entered 
must match that in the START command or 


link table for the 
completed. 


Sign-on procedure to be 
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SML, operating in RJE mode, transmits files 
consisting of job control records and data 
to remote MULTI-LEAVING batch systems such 


as HASP and ASP. These files can criginate 

from: 

e VM/370 users’ spooling the files to 
RSCS. 


e Remote terminals submitting card decks, 
through an NPT line driver with valid 
tag information in the ID card. 


e Remote stations submitting card decks, 
through an SML line driver operating in 
HOST mode, with valid tag information in 
the ID card. 


When the remote batch systen has 
completed processing the data, printer 
and/or punch output is transmitted back to 
SML. This output is then printed or punched 


on the appropriate real I/O device. 


INPUT FILE PROCESSING 


ee 


(HOST MODE) 


The remote station submits input to the 


RSCS machine through the remote card 
reader. This input can be directed to the 
virtual reader of a VWM/370 user or to 


another remote terminal or station. Output 
processing at the remote station can 
usually be interrupted at any point to 
allow the transmission of input data. The 
specific procedure for interrupting output 
processing varies according to the remote 
hardware being utilized; this is explained 


in the "Operating Precedures" for the 
specific remote station. When the input 
has been processed, output processing can 


be resumed from the point of interruption. 


A control card is placed in front of the 
deck to be sent from the remote station to 
the virtual machine card reader of a user 
or to another remote terminal or station. 
The format of this card is as follows: 


Col 1 10 


ee ee oe 


I ID | userid [tagtext ] | 


a aad aha Lee cs cy ng ani inspec ea eet ca Ca epi cia asrpeial 
where: 
userid is the userid of a virtual 


machine to receive the card deck 
that follows. 


ME, 


tagtext is a string of parameters 
consistent with the use of the 
spool file tag field by RSCS. 


that of the RSCS 
Machine, and if the tagtext 
valid RSCS linkid, RSCS 
input file to the remote 
station specified by the 


If the userid is 
virtual 
contains a 
transmits the 
terminal or 


linkid. 


Note: If the remote system console is used 
to enter the ID data, upper case notation 
must be used. 


QUTPUT FILE PROCESSING (HOST MODE) 


When printer and punch files are 
transmitted to a remote terminal, a header 
line is created on the output to identify 
the originating userid, date, and time of 
transmission. Card decks punched at the 
remote terminal contain the source header 
information on the first card punched; the 
rest of the card is filled with 
Printer files use a carriage control tape 
with channel 1 signifying the first print 


eee ews 


line. 
In addition, to header information, 
printer files are separated from one 


another by header pages which may be seen 
by the operator, at the edge of the unburst 
paper, to allow the operator to separate 
printed output. The header page format is 
as follows: 


- page eject 

- skip 61 lines 

- 5 lines of n asterisks per line 
- 1 line of n underscores 

- 5 lines of n asterisks per line 
- 2 blank lines 

- the source header line 

- page eject 

- the print file 


120 or the number of printable 
the remote printer, 


where n is 
positions available on 
whichever is less. 

file 


The card and print header 


information is as follows: 


Meaning 

file origin location 

file origin virtual 
machine 

file origin date 

file origin time 


13 VVOVOVE 


25 an/dd/yy 
37 hh:mm:ss 
55 WAS THE ORIGIN 


REMOTE STATION OPERATOR COMMANDS 


The remote station operator, under control 
of SML in HOST mode, is allowed to usea 
subset of the RSCS commands. In general, 
the remote operator can issue commands that 
affect cnly his specific link. The 
commands are described below, by functional 
grouping. A complete description of all 
commands, with detailed format, can be 
found in "Appendix A: Remote Spooling 
Communications Subsystem Commands." 


Note: With the exception of the MSG 
command, the linkid operand is not’ to be 
entered by a remote station operator when 


submitting commands to RSCS. 


LINK AND LINE CONTROL COMMANDS 


Use the DRAIN command to deactivate 
link. If the link is currently processing 
a file, the link is deactivated as soon as 
the current file is processed. If no file 
is being processed, the link is deactivated 
immediately. 


your 


If the link is currently logging I/0 
activity, the DRAIN command will terminate 
logging and automatically print the log 
output. 


The HOLD Command 


ae eee ee we ee 


Use the HOLD command to temporarily suspend 
file transmission on your link without 
deactivating it. Transmission is suspended 
at the end of the file currently being 


processed unless a keyword is entered 
signifying that transmission is to be 
halted immediately. In either case, 
transpission is restarted at the 
interrupted point when the FREE command is 
issued. 

The FREE Command 


Use the FREE command to resume transmission 
on your link, previously in HOLD status. 
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FILE CONTROL COMMANDS 


Use the CHANGE command to alter one or more 
file attributes of a file enqueued on your 
link's file queue, and not currently 
active. 


Use the ORDER command to reorder the files 


engueued on your link's file queue. This 
redefines the order in which particular 
files are processed. A file currently 


being processed can not be reordered. 


The PURGE Command 


Use the PURGE command to remove all or 
specific files enqueued on your link's file 
queue from the system before they are 
processed. A file currently being processed 
cannot be purged. 


The FLUSH Command 


nd 


Use the FLUSH command to 

processing the current file on 
The discontinued file is either purged or 
held, and processing continues with the 
next file engqueued for transmission on your 


discontinue 
your link. 


link. If the COPY attribute.for the file 
specified multiple copies, only the copy 
currently being processed is flushed, 


unless you also specify that all copies of 
the current file be flushed. 


The EACKSPAC Command 


Use the BACKSPAC command to restart or 
reposition, ina backward direction, the 
file currently being processed on your 
link. 
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ed 


Use the FWDSPACE command to reposition, in 
a forward direction, the file currently 
being processed on your link. 


The START Command (for an active link) 


Use the START command with the CLASS 
operand to change the classes of files that 
are processed on your link or to reseta 
DRAIN operation before it has completed. 


COMMUNICATIONS COMMANDS 


Use the MSG command to send a message to 
the RSCS operator, a local VM/370 user, or 
to another remote station or terminal. 


MISCELLANEOUS COMMANDS 


The QUERY Command 


Use the QUERY command to request RSCS 
system status information for a particular 
link, a specific file, or for the system in 
general. 


A subset of RSCS 
printed on the 
Generally, they 


operator messages are 
remote station console. 
are responses to commands 
Originating at the remote station. For a 
key to the distribution of messages, see 
“Appendix B: RSCS Message Summary." 


neti, 


Part 3. Nonprogrammable Remote Terminals 


Part 3 contains operational information for 
each of the following remote 
nonprogrammable terminals Supported by the 
NPT line driver operating under RSCS: 

IBM 2770 Data Communication System 


IBM 2780 Data Transmission Terminal, 
Models 1 and 2 


IBM 3770 Data Communication Systen, 
nonprogrammable models 


IBM 3780 Data Communications Terminal 
The following topics are discussed as they 
relate to each terminal: 
e Supported configuration 
e Operational notes 
e Entering commands 


e Error recovery procedures 
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ARs, 


SUPPORTED CONFIGURATION 


The IBM 2770 Data Communication System with 
the 2772 Multipurpose Control Unit 
(hereinafter called 2770) can be uSed as an 
NPT remote terminal. It can be connected 
to RSCS via a Switched or leased 
point-to-point communication line. 


The following devices and features are 


required for operating a 2770 as an NPT 

remote terminal: 

e One IBM 2213 Printer, Model 2, or one 
IBM 2203 Printer, ofr one IBM 1053 
Printer 


nAenaAn 


e One IBH 2502 Card Reader, Model Ai or AZ 
e EBCDIC Transmission Code 
Other supported equipment and features 


are as follows (feature numbers are shown 
in parentheses) : 


e One IBM 545 Card Punch, Model 3 
with or without 3590 attachment. 


or 4, 


e EBCDIC Transparency (3650) 

e Buffer Expansion (1490) 

e Additional Buffer Expansion (1491) 
(6555) 


e Space Compression/Expansion 


e Synchronous Clock (7705) 


2770 OPERATIONAL NOTES 


Establishing the connection with RSCS is 
the same for all nonprogrammable terminals 
and is covered in "Part 2. Components of 
RSCS" under "Starting NPT" and "Signing on 


to NPT." 
During all 2770 terminal sessions with 
NPT, the 2770 console switches should be 


set as follows: 


IBM 2770 as a Remote Terminal 


Switch Setting 
JOB SELECT VARIABLE SELECT SELECT 
INPUT KEYBOARD, 2 
(card reader) both up 
OUTPUT PRINTER, 2 
(card punch) both up 


DIRECT DATA OUTPUT PRINTER up 

TERM MODE LINE 

SELECTION REQD down 

ANSWER MANUAL 

MONITOR PRINT as desired by 
installation, 


normally down 
Any of above that refer 


to device not on your 2770 down 
All other VARIABLE SELECT 
Switches down 


During installation, your 2770 may have 
been provided with the equivalent of all 
the above switch settings at one of the 
five JOB positions on the JOB SELECT 
Switch. If so, simply set to that position 
and ignore all VARIABLE SELECT switches. 
When power is on, console lights show the 
settings that are in effect. 


The TRANSPCY switch should be set in the 
down position except when used for 
transmitting EBCDIC card decks that use all 
256 possible punch combinations. 


ENTERING COMMANDS 


The remote terminal operator subnits 
commands to RSCS through the remote card 
reader in the same manner as he enters card 
files. The commands are punched, one per 
card, starting in column 1. One or more 
commands may be submitted at any one time, 
Commands are only accepted before the ID 
card of an input card deck or after an 
input card deck. has_ been completely 
processed (end-of-file generated). 


TERMINATING A SESSION 


To terminate a session, the remote terminal 
operator issues the DRAIN command. The link 
is deactivated after the file currently 
being processed is completed. 
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ERROR RECOVERY PROCEDURES 


Most problems you encounter result in 
lights appearing on the 2770 console or the 
I/O devices themselves. Some lights are not 
error lights; these are DATA SET READY, 
CARRIER OFF, DATA IN BUFFER, LINE MODE, 
PROCEED, BID, SELN REQD, TRANSPCY, MANUAL 
ANSWER, and any of the I/O device lights 
that are not blinking. Any I/0 device light 
which is blinking indicates that the device 
is not ready. Other lights provide clues to 
problems and are discussed in the following 
sections. 


ERROR RECOVERY FOR A LINE DROP 


If for any reason a line drop occurs, all 
activity at the remote terminal halts. If 
the terminal was receiving, the printer or 
punch will = stop. If the terminal was 
transmitting, the reader stops and _  RSCS 
closes the partially transmitted file. 


In order to restart, you must redial the 
line and reenter your SIGNON card. When 
the SIGNON card is accepted by RSCS, normal 
line activity will resume. If receiving, 


activity will restart from the point of 
interruption. If transmitting, you can 
either restart the file that was 


interrupted or you can send the rest of the 
data as a separate file. 


If some other user dials in on the 
disconnected line before you do and submits 
his own SIGNON card, RSCS will recognize 
the new linkid as being different from the 
one in effect at the time the line dropped. 
The new user is terminated and the link is 
deactivated. If your terpinal was 
receiving, the printer or punch file is 
placed at the end of the queue for your 
link and is put into HOLD status. 

To restart under these 
you must first have 
reactivate your link 
command. You can then 
resubmit your SIGNON card. 
card is accepted, line 
resume. Transmission can be either 
continued or restarted. Printer or punch 
output will resume with the file following 


circumstances, 
the RSCS operator 

via the START 
redial the line and 
When the SIGNON 
activity will 


the one that was active at the time the 
line dropped. In order to process the 
interrupted file, you must change its 
Status from HOLD to NOHOCLD via the CHANGE 
command. 


ERROR RECOVERY WHEN TRANSMITTING 


When transmitting, any card reader trouble 
is indicated by a blinking INPUT 2 or 3 
light; whichever your card reader is 
attached to. The following lights on the 
card reader may further indicate the type 


of trouble: 


FEED CHECK 
The botton 
to feed. 
hopper. 


card in the 
Remove the 
Press 


hopper failed 
cards from the 
the Non-Process Runout 
(NPRO) button. Repair the bottom 
hopper card, if necessary, and make 
sure the feed throat is clear. Reload 
the cards and push reader START and 
console START. 


ATTENTION 
Full stacker or empty hopper with EOF 
off. Correct the problem, then push 
reader START and console START. 


READ CHECK 

VALIDITY CHECK 
Last card in the stacker (if 
and the following card 
NPRO after hopper cards are removed) 
must be re-read. After appropriate 
correction, place these two cards at 
the front of the card stack in the 
hopper, push reader START and console 
START. 


no jam) 
(run out by 


TERMINAL ADDRESS 

The NPT program is trying to. send 
output while you are trying to start 
an input function. Continue the input 
procedure until you have turned on the 
BID light. Then press CHECK RESET and 
wait for input to begin. Press CHECK 
RESET again if TERMINAL ADDRESS comes 
on again. 


BID RETRY 
The NPT program has failed to give 
permission to transmit. Press CHECK 
RESET to cause the 2770 to try again. 
If this fails, ask the local RCSC 
operator to check the task. 


INPUT CHECK 

BUFFER CHECK 

TRNSPCY CHECK 
With any one of these serious errors, 
you must always do a job restart. Make 
sure you have turned on the TRANSPCY 
Switch if the input card deck contains 
object decks or other cards requiring 
transparent transmission. 


RECORD CHECK 

LINE CHECK 
These lights may come 
attempting 
errors; they 


on while NPT is 
retransmissions for line 
will go out if recovery 


AE 


is successful. If they stay on and the 
transmission does not proceed, you 
must do a CHECK RESET and restart the 
output device for the output to 
continue. 


Note: It is possible, in this case, to 


lose arecord, or to have a_ record 
duplicated. 


ERROR RECOVERY WHEN RECEIVING 


indicated by 
OUTPUT 2 lights 


Output device trouble is 
blinking OUTPUT PRINTER or 
on the devices as follows: 


CARRIAGE CHECK 
The printer carriage, forns, or 
carriage tape are not ready or jammed. 


Correct the condition and press 
console CHECK RESET and START. 

PRINT CHECK 
The printer had a parity error. Press 
console CHECK RESET and START. Failure 
to recover indicates hardware 
trouble. 

CHECK light or any card punch not 

ready condition 
Hopper empty, stacker fuil, or jams 
are the possible causes. Set the 
keyboard switch to KEYPCH. Remove any 
cards from the stacker or the eject 
station just below the stacker and 
discard all cards after the last one 
with a ocolumn 80 punch. Clear the 
entire card feed path. With blank 
cards in the hopper, press the FEED 


key twice and the RELEASE key once and 
then set the switch to AUTO PCH. Press 
console CHECK RESET and START. The 


first card through the feed after 
recovery is blank and should be 
discarded. 

When receiving, certain console lights 


may require your attention as follows: 


TERMINAL ADDRESS 
The WPT program is 
output but your 2770 is not ready. 
Make sure your Switch setup is 
correct, ready all output devices, and 
press console CHECK RESET. 


trying to send 


OVERRUN 

This usually indicates that 
on your 2770 were not specified 
correctly when you signed onto the 
RSCS virtual machine. Ask the RSCS 
Operator either to restart the task in 
order to send the correct SIGNON card 
or to change the recorded 
configuration. 


features 


BUFFER CHECK 
serious hardware error always 


This 
requires you to reset and restart the 
operation. Failure to recover 
indicates hardware trouble. 

LINE CHECK 
The NPT program is attempting 
retransmissions. if they are 
successful, the light goes out. If 


the light stays on and printing or 
punching does not continue within a 
short time, you must do a line 
restart. 


For other combinations of error iighis 
consult the publication 
IBM 2770 Data 


GA27-3013. 
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IBM 2780 as a Remote Terminal 


The IBM 2780 Data Transmission 
Models 1 and 2, 


Terminal, 
used as NPT remote 
terminals, can be connected to RSCS viaa 
Switched or leased point-to-point line. 
EBCDIC Transmission, feature code 9762, is 


The following supported features are 
optional (feature numbers are in 
parentheses): 


e EECDIC Transparency (8030) 


e 120/144-Character Print Line . 


5821) 


(5820 or 
e Multiple Record Transmission (5010) 


e Synchronous clock (7705) 


2780 OPERATIONAL NOTES 


Establishing the connection with RSCS is 
the same for all nonprograrmmable terminals 
and is covered in “Part 2. Components of 


RSCS" under "Starting NPT" 
to NPT." 


and "Signing on 


After having established the connection 
with RSCS, the following steps must be 
performed: 


1. Make sure that the mode-selection knob 


is at one of the positions TSM-TRSP, 
TSM, or REC. Do not put the’ knob in 
the PRINT or PUNCH position (to 
receive a punch file put the’ knob in 
REC position). 
2. Push START on the printer. 
ENTERING COMMANDS 
The remote terminal operator submits 


commands to RSCS through the remote’ card 
reader in the same manner as he enters card 
files. The commands are punched, one per 
card, starting in column 1. One or more 
commands may be submitted at any one time. 
Commands are only accepted before the ID 
card of an input card deck or after an 
input card deck has been completely 
processed (end-of-file generated). 
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To terminate a session, the remote terminal 
operator issues the DRAIN command. The link 
is deactivated after the file currently 
being processed is completed. 


ERROR RECOVERY PROCEDURES 


Most problems you encounter result in 
lights appearing on the reader-punch or 
printer control panels. Some lights are not 
error lights; these are DATA SET READY, the 
two READY lights, END OF FILE, I/O BFR 
FULL, CTR1, CTR2,CTR4 and usually LINE. 


POWER-ON reset 

The POWER-ON reset operation is 
referred to frequently throughout this 
manual. Contrary to its name, a 
POWER-ON reset does not involve the 
2780 POWER ON/OFF switch (on the right 
side of the 2780); this switch needs 
to be turned on only once during 2780 
operations. You can perforn a 
POWER-ON reset by turning the mode 
selection switch knob from its current 
position to any other position. This 
resets the 2780. If the knob is 
already where- you want it, then turn 
it to some other position and back to 
the desired one. 


CAUTION: Do not do a POWER-ON reset 
when the printer is printing, or while 
cards are being read or punched. 


ERROR RECOVERY FOR A LINE DROP 


If for any reason a line drop occurs, all 
activity at the remote terminal halts. If 
the terminal was receiving, the printer or 
punch will stop. If the terminal was 
transmitting, the reader stops and RSCS 
closes the partially transmitted file. 


In order to restart, you must redial the 
line and reenter your SIGNON card. When 
the SIGNON card is accepted by RSCS, normal 
line activity will resume. If receiving, 


activity will restart from the point of 
interruption. If transmitting, you can 
either restart the file that was 


interrupted or you can send the rest of the 
data as a separate file. 


tl, 


If some other user dials in on the 
disconnected line before you do and submits 
his own SIGNON card, RSCS will recognize 
the new linkid as being different from the 
one in effect at the time the line dropped. 
The new user is terminated and the link is 
deactivated. If your terminal was 
receiving, the printer or punch file is 
placed at the end of the queue for your 
link and is put into HOLD status. 

To restart under these circumstances, 
you must first have the RSCS operator 
reactivate your link via the START 
command. You can then redial the line and 
resubmit your SIGNON card. When the SIGNON 
card is accepted, line activity will 
resume. Transmission can = be either 
continued or restarted. Printer or punch 
output will resume with the file following 
the one that was active at the time the 
line dropped. In order to process the 
interrupted file, you must change its 
status from HOLD to NOHOLD via the CHANGE 
command. 


ERROR. RECOVERY WHEN TRANSMITTING 


TERM ADDR 
This light comes on when you are 
reading cards. If the cards stop 
reading and the READY and TERM ADDR 


lights are the following 


steps: 


on, perform 


1. Remove the cards from the hopper 
and press NPRO to run out the two 
cards in the feed. 


2. Put these two cards in front of 
the deck previously removed if 
Step 1, and place the cards back 
in the hopper. 


3. Do a POWER-ON reset. 


4. Wait for the TERM ADDR light to 
come oh again. This may take as 
long as 10 seconds. 


5. Do another POWER-ON 
the END OF FILE 
that the END OF FILE and 
lights come on. 


reset, press 
and START, so 
READY 


6. Cards should start reading within 
15 seconds. If they do not, and 
the TERM ADDR light comes on 
again, repeat the above steps. 


If the 
you may 
punching to 


above steps continue to fail, 
have interrupted printing or 
read in cards’ before the 


printing or punching had completed. 
Try to ready the printer and punch. 


DATA CHECK 
CATA CHECK and EQUIP CHECK 
DATA CHECK, EQUIP CHECK, and PARITY CHECK 


The reader could not read a card 
correctly. Perform the following 
steps: 


1. Remove cards from the hopper (not 
the stacker). 


2. Press NPRO. Two cards will run 
out into the stacker. The first 
of these cards is the bad one. 


3. Correct the bad card. 
4. Put both cards back in the 
hopper, follcwed by the cards you 


removed from the hopper. 


5. Press END OF FILE and START so 


that the END OF FILE and READY 
lights come on. 
OVER RUN 
PARITY CHECK 
PARITY CHECK and EQUIP CHECK 
RECORD and LINE 
To correct errors when these lights 
are on, you must first find ont how 


many cards have been read but not yet 
transmitted. Add up the CTR lights to 
do this. Por example, if CTR1 and CTR2 
are on, three cards have been read, 
but not yet transmitted. Without 
removing all cards from the stacker: 


1. Remove the cards fron the 
hopper. 
2. Press NPRO to run out the two 


cards in the feed mechanisn. 


3. Remove the last N+t2 cards from 
the stacker, where N is the 
number of cards read but not yet 
transmitted. 


4. Put these cards back into the 
hopper, followed by the cards you 
removed from the hopper in Step 
1. Do a POWER-ON reset. 


5. Press END OF FILE and START so 
that END OF FILE and READY lights 
come on. 


EQUIP CHECK 
A mechanical error has occurred. Use 
the procedure for DATA CHECK, but you 
should not need to correct a card. 
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LINE 
Wait a few moments to see whether or 
not the reader starts reading cards by 
itself. If it does not: 

1. Press STOP. 

2. Press END OF FILE and START so 
that the END OF FILE and READY 
lights come on. 

HOPR 


No card was fed. Check the bottom card 
in the hopper for damaged edges. 
Repair or remake the card and replace 
it and the rest of the cards’ back in 
the hopper. Press END OF FILE and 
START so that the END OF FILE and 
READY lights come on. 


ERROR RECOVERY WHEN RECEIVING 


Some of the errors you may encounter when 
receiving are self-explanatory, such as END 
OF FORM (another box of paper is needed) or 
FORM CHECK (the paper is jammed). 


One error deserves particular 
attention. It is indicated by OVER RUN and 
INCP. If you get this error, you may have 
specified the wrong remote configuration on 
the SIGNON card and NPT is attempting to 
use features your 2780 Data Transmission 
Terminal does not have. Ask the _ RSCS 
operator either to restart the task, in 
order to send the correct SIGNON card, or 
to change the recorded configuration in the 
RSCS link table via the DEFINE command. 


You may also see the following error 
indicators: 
TERM ADDR 
The device (printer or punch) is not 
ready. 


1. Press STOP and CHECK RESET on the 
reader-punch. 


2. Make the output device ready. 
EQUIP CHECK 


There is 
the punch. 


a mechanical malfunction of 


1. Press NPRO to run out the cards 
in the feed mechanism and discard 
then. 


2. Make the punch ready again. 


SYNCH CHECK 
The printer has 
containing errors. 


printed a line 


1. Press STOP. 
2. Press RESET (on printer). 


3. Press the START button on the 
printer; the line is reprinted. 


PARITY CHECK 
If the printer was printing, do a 
POWER-ON reset and fress START on the 
printer. (You may get some duplicate 
print lines.) 


If the punch was punching: 


1. Remove cards from the hopper (not 
the stacker). 


2. Press NPRO to run out the two 
cards in the feed mechanisn. 


3. Throw away the last N+K cards 


that were stacked. 


where: 
N is the number represented by 
the CTR lights. For example, 


if CTR1 and CTR2 are lit, Nis 
3; if all CTR lights are off, 
N 


is 0. 

K = 2 if all CTR lights are off 
or if the I/O BFR FULL light 
is off. 

= 11if any of the CTR lights 
and the I/0 BFR FULL light 
are on. 


4. Reload blank cards in the hopper 
and make the punch ready 


of error lights, 
21780 Data 
Component 


For other combinations 
consult the publication IBM 
Transmission Terminal a 


Description, Order No. GA27-3005. 


sti 
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SUPPORTED CONFIGURATION 

The IBM 3770 Data Communication System can 
be used as an NPT Tremote station only when 
operating in 2770 or 3780 BSC mode. It can 
be connected to RSCS via a switched or 
leased point-to-point communication line. 
The IBM 3770 is only supported on a 
communicaticn line terminating in an 
Integrated Communications Adapter (ICA) on 
the System/370 Model 135, an IBM 2701, or 
an IBM 3704/3705 Communications Controller. 


The 3770 keyboard is not supported; 
however, by using the IRS character, the 
3770 keyboard can be used to simulate a 


card reader. 


The follcwing devices and features are 


required for operating the 3770 as an NPT 
remote station: 
e One of the following communication 
terminals: 
IBM 3771 Models 1, 2, and 3 (in 2770 
mode) 
IBM 3773 Models 1, 2, and 3 (in 2770 
mode) 
IBM 3774 Models 1 and 2 (in 2770 mode) 


IBM 3775 Model 1 (in 2770 mode) 

IBM 3776 Models 1 and 2 (in 2770 or 3780 
mode) 

IBM 3777 Model 1 (in 2770 or 3780 mode) 

e One IBM 2502 Card Reader, Model Al, A2, 
or A3; IBM 3501 Card Reader or IBM 3521 
Card Punch with the Read feature 
installed. 


The 3774 and 3775 programmable terminals 
are supported only for console printer 
output and for input (in card image format) 


from the diskette or keyed in from the 
keyboard. For further information on these 
terminals, refer to the following 
publications: 

IBM 3773, 3774, and 3775 Programmable 


Communication Terminals: 


OS CS Oe GP ae oe ee ae 


The following features/functions are 
standard on a 3770 with 2770/3780 BSC 
compatibility: 


e EBCDIC transmissicn code 


IBM 3770 as a Remote Terminal 


e EBCDIC transparency 


e 256/256 byte alternating buffers (2770 
mode) 
e 512/512 byte alternating buffers (3780 


mode) 

e Extended retry 

e External clock (up to 4800 BPS) 

e WACK response 

e Vertical form control 

e Device selection 

e Expanded print line (132 positicns) 

* Transmit/receive HOnitor print (the 2770 
prints only after it receives positive 


acknowledgement from the line. The 3770 
always prints.) 


Other supported equipment and features 


are as follows: 


e One IBM 3521 Card Punch 
e One IBM 3784 Line Printer (standalcne) 
e Space compression/expansion 
e Magnetic disks (#4901, 4902) 
If installed, the magnetic disk can give 
expanded input/output capability with 


2770/3780 BSC operations. 


When the 3770, is in 2770/3780 RSC mode, 
it has two operator-selected mcdes for 
remote component selection: 

1. Data to Selected Device with Default 
Printer: In this mode of 
Operation, the data from the line is 
directed to the output device 
specified by the component selection 
([C) character received. Component 
selection characters used are as 
follows: 


Console Printer 
Card Punch 

Disk 

Line Printer 


pC1--Selects 

pDC2--Selects 

pDC3--Selects 

pDc4--Selects 
If no component selection (DC) 
character is received, an automatic 
default occurs to output the data to 
the console printer. 
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2. Data to Magnetic Disk with Transparent 
Data to Punch: In this mode of 
operation, the data from the line is 
directed to the magnetic disk unless 
it is transparent data. Tf 
transparent data is received, it is 
directed to the punch. If component 
selection (DC) characters are 
received, they are stripped off and 
ignored, 

3770 OPERATIONAL NOTES 
Establishing the connection With RSCS is 


the same for all nonprogrammable terminals 
and is discussed in "Part 2. Components of 


RSCS" under "Starting NPT" and “Signing on 
to NPT", 
Operation of the 3770 system is 


discussed in the following publications: 


IBM 3771 and 3773 Comm 
Order No. 


GA27-3100 


IBM 3774 and 3775 Communication Terminals 


Order No. GA27-3094, 


IBM 3776 Communication Terminal, 


Order No. GA27- 3107 


Ie 


IBM 3777 Communication Terminal, 


SS eee ee a a ee aw a ee eee a eS ee 


Order No. GA27-3124. 


ENTERING COMMANDS 


a ee ee 


The remote terminal operator submits 
commands to RSCS through the remote card 
reader in the same manner as he enters card 
files. The commands are punched, one per 
card, starting in column 1. One oF more 
commands may be submitted at any one time. 
Commands are only accepted before the ID 
card of an input card deck or after an 
input card deck has been completely 
processed (end-of-file generated). 


To terminate a session, the remote terminal 
operator issues the DRAIN command. The link 
is deactivated after the file currently 
being processed is completed. 


unication Terminals 
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ERROR RECOVERY 
The OPRN CHECK (Operational Check) 
indicator turns on when an operating 
procedure error occurs, or an input or 


output device needs some operator attention 
(such as a printer out-of-forms condition). 
An error code displays in the numeric 
position readout (NPR) indicators. 


The SYSTEM CHECK indicator turns on when 
a controller, or an input or output device 
error occurs. An error code displays in the 
humeric position readout (NPR} indicators. 


The operator panel speaker sounds when 


an operational check or a system check 

occurs; if installed, the audible alarm 

sounds for jobs other than keyboard jobs 
when the FXTEND/ALARM switch is on. 

When the 3770 stops due to an error or 
an attention condition: 

e Either the SYSTEM CHECK or the OPRN 
CHECK indicator is on. 

e If an input or output device error 
occurred, the operator panel indicator 
for the device in error turns on. 

e The number displayed in the readout 


(NPR) indicates the error type. 


If the 
RESET key to turn it 
recovery procedure 
error code number 
section "Numeric hapa 
Error Codes" in 


audible alarm sounds, 
off. For 
that applies to the 
displayed, see the 
Readout (NPR) 
Procedures 


press the 
the error 


ERROR RECOVERY FOR A LINE DROP 


If for any reason a line drop occurs, all 
activity at the remote terminal halts. If 
the terminal was receiving, the printer or 
punch will stop. If the terminal was 
transmitting, the reader stops and RSCS 
closes the partially transmitted file. 


In order to restart, you must redial the 
line and reenter your SIGNCN card. When 
the SIGNON card is accepted by RSCS, normal 
line activity will resume. If receiving, 


activity will restart from the point of 
interruption. If transmitting, you can 
either restart the file that was 
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interrupted or you can send the rest of the 
data as a separate file. 


If some other user dials in on the 
disconnected line before you do and submits 
his own SIGNON card, RSCS will recognize 
the new linkid as being different from the 
one in effect at the time the line dropped. 
The new user is terminated and the link is 


deactivated. If your terminal was 
receiving, the printer or punch file is 
placed at the end of the queue for your 


link and is put into HOLD status. 
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To restart under these circumstances, 
you must first have the RSCS' operator 
reactivate your link via the START command. 
You can then redial the line and resubmit 
your SIGNON card. When the SIGNON card is 
accepted, line activity will resume. 
Transmission can ke either continued of 
restarted. Printer or punch outfut will 
resume with the file following the one that 
Was active at the time the line drecfrped. 
In order to process the interrupted file, 
you must change its status from HOLD to 
NOHOLD via the CHANGE command. 


48.1 


SUPPORTED CONFIGURATION 


The IBM 3780 Data Communications Terminal, 
used aS an NPT remote station, can be 
connected to RSCS via a switched or leased 
point-to-point communications line. EBCDIC 
transmission code is required. 


The following devices and features are 
optional (feature numbers are in 
parentheses) : 

e One IBM 3781 Card Punch 


e Component Selection (1601, 
the 3781) 


required for 


e EBCDIC Transparency (3601) 
e Additional Print Positions (5701) 


e Synchronous Clock (7705) 


Establishing the connection with RSCS is 
the same for all nonprogrammable terminals 
and is covered in "Part 2. Components of 


RSCS" under "Starting NPT* 
to NPT". 


and "Signing on 


During 3780 operations with NPT certain 


3780 console switches should be set as 
follows: 
Switch Setting 
TERM MODE LINE/HOME LINE 
TRNSPCY ON or OFF as 
desired 
SPACE COMPRESS/EXPAND ON or OFF as 
desired 
OFF LINE TEST OFF 
AUTO RESTART ON 
INQUIRY MODE OFF 
ANSWER AUTO/MAN OFF 


TELE (WORLD TRADE ONLY) OFF 


SPEED (WORLD TRADE ONLY} At the desired 
transmission 
speed 

ENTERING COMMANDS 
The remote terminal operator submits 


commands to RSCS through the remote card 
reader in the same manner as he enters card 


IBM 3780 as a Remote Terminal 


files. The commands are punched, 
card, starting in column 1. One or more 
commands may be submitted at any one time. 
Commands are only accepted before the ID 
card of an input card deck or after an 
input card deck has been completely 
processed (end-of-file generated). 


one per 


INTERRUPTING OUTPUT PROCESSING 


If it becomes necessary to enter a command 
or an input card file while the terminal is 
busy with a lengthy output processing, the 
output may be interrupted as follows: 


1. Ready the card reader with the input 
cards (commands and/or data). 
2- Press TERM RESET 
3. Press START on the console. 
Note: Due to the Nature of the 3780 


hardware, print or punch records that were 
in the 3780 buffer when TERM RESET was 
pressed will be lost by this procedure. 
The alternative is to wait until the output 
processing has completed. 


TERMINATING A SESSION 


To terminate a session, the remote terminal 
operator issues the DRAIN command. The link 
is deactivated after the file currently 
being processed is completed. 


ERROR RECOVERY PROCEDURES 


Most problems you encounter result in 
lights appearing on the 3780 console and on 
the I/0 devices themselves. Some . lights 
are not error lights; these are DATA SET 
READY, CARRIER OFF, DATA IN BUFFER, LINE 
MODE, BID, TRANSPCY, MANUAL ANSWER, and any 
of the I/0 device lights when on steady. 
Any I/0 device light that is blinking 
indicates that the device is not ready. 
Other lights provide clues to problems and 
are discussed in the following sections. 
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ERROR RECOVERY FOR A LINE DROP 


If for any reason a line drop’ occurs, all 
activity at the remote terminal halts. If 
the terminal was receiving, the printer or 
punch wiil stop. If the terminal was 
transmitting, the reader stops and RSCS 
closes the partially transmitted file. 


In order to restart, you must redial the 
line and reenter your SIGNON card. When 
the SIGNON card is accepted by RSCS, normal 
line activity will resume. If receiving, 


activity will restart from the point of 
interruption. If transmitting, you can 
either restart the file that was 


interrupted or you can send the rest of the 
data as a separate file. 


If some other user dials in on the 
disconnected line before you do and submits 
his own SIGNON card, RSCS will recognize 
the new linkid as being different from the 
one in effect at the time the line dropped. 
The new user is terminated and the link is 


deactivated. If your terminal was 
receiving, the printer or punch file is 
placed at the end of the queue for your 


link and is put into HOLD status. 


To restart under these circumstances, 
you must first have the RSCS operator 
reactivate your link via the START 
command. You can then redial the line and 
resubmit your SIGNON card. When the SIGNON 
card is accepted, line activity will 
resume. Transmission can be either 
continued or restarted. Printer or punch 
output will resume with the file following 
the one that was active at the time the 
line dropped. In order to process the 
interrupted file, you must change its 
status from HOLD to NOHOLD via the CHANGE 
command. 


ERROR RECOVERY WHEN TRANSMITTING 


When transmitting, any card reader trouble 
is indicated by a blinking reader light. 
The following lights on the card reader may 
further indicate the type of trouble: 


FEED CHECK 
The bottom card in the hopper failed 
to feed. Remove hopper cards. Press 
NPRO. Repair the bottom hopper card, 
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if necessary, and make sure the feed 
throat is clear. Reload the cards. 
Press reader START and console START. 


ATTENTION 


Full stacker or empty hopper with EOF 


OFF. Correct the problen, press 
reader START and console START. 

READ CHECK 

VALIDITY CHECK 
Last card in stacker (if no jam) and 


following card (run out by NPRO after 


hopper cards are removed) must be 
re-read. After appropriate 
correction, place these two cards at 


the front of the unprocessed cards in 


the hopper, push reader START and 
console START. 

TERMINAL ADDRESS 
The NPT program is trying to. send 
output while you are trying to start 
an input function. Continue input 


procedure until you have turned on the 
BID light. Then press CHECK RESET and 
wait for input to begin. Press CHECK 
RESET if TERMINAL ADDRESS comes on 
again. 


INPUT CHECK 
BUFFER CHECK 
TRNSPCY CHECK 


With these serious errors you must 
always doa job restart. Make sure 
that you have turned on the TRANSPCY 


switch if the input card deck contains 
object decks or other cards requiring 
transparent transmission. 


RECORD CHECK 

LINE CHECK 
These lights may come on while NPT is 
attempting retransmissions for line 
errors; they will go out if recovery 
is successful. If they stay on and 
the transmission does not proceed, you 
must do a CHECK RESET and restart the 
input device. The input is continued; 
however, it is possible in this case 
to have a record duplicated. 


ERROR RECOVERY WHEN RECEIVING 


Output device trouble is indicated by a 
blinking printer light on the console panel 
or EQUIP CHECK on the 3781 Card Punch 
panel. 


la a, 


FORM CHECK 
CARRIAGE INTERLOCK 
END-OF-FORM 


The printer carriage, forms, or 
carriage tape are not ready Or 
jammed. Correct the condition; press 
CHECK RESET and START on the console 
panel. 

BUFFER CHK 
The printer had a parity error. Press 
CHECK RESET and START on the console 
panel. Failure to recover indicates 
hardware trouble. 

EQUIP CHECK 
The punch has mechanically 
malfunctioned. Run out the cards in 
the feed mechanism and discard them. 


Make the punch ready again. 


When receiving, certain other console 
lights may require your attention, as 
follows: 


TERMINAL ADDRESS 
The NPT program is trying to 
output but your 3780 is not 
Make sure your Switch setup 
correct, ready all output devices, 
press console CHECK RESET. 


BUFFER CHECK 
This serious hardware 
requires you to reset 
operation. Failure to 
indicates hardware trouble. 


error al 


LINE CHECK 

The NPT program is attemp 
retransmissions. If NPT 
successful, the light goes out. 
the light stays on and printing 


punching does not 


send 


ready. 


is 
and 


ways 


and restart the 
recover 


tin 
is 
If 
or 


continue within a 


short time, you must do a line 
restart. 
For other combinations of error lights, 
consult the publication Component 
Information for the IBM 3780 


ee ee er a ee ee 
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Part 4. Spool MULTI-LEAVING Remote Stations 


Part 4 contains operational information for 
each of the following remote programmable 
MULTI-LEAVING stations supported by the SML 
line driver operating in HOST mode under 
RSCS: 


IBM System/360 

IBM System/370 

IBM System 360 Model 20 

IBM 2922 Programmable Terminal 
IBM Systen/3 Model 10 Card System 


marae ee ws 


IBM 1130 Systen 


The following topics are described as 
they relate to each station: 


e Supported configuration 


Remote Station Processor progran 
functions 


e Operating procedures 
e Error Recovery Procedures 


Another section provides information on 
the use of the RSCS virtual machine asa 
Remote Job Entry workstation communicating 
with a HASP/ASP-type batch processor. 


In addition, MULTI-LFAVING Remote Job 
Entry Work Station (MRJE/WS) support is 
briefly described for the following remote 
stations: 


IBM System/3 Models 6, 8, 10, 12, and 15 
IBM Systemn/32 


The MRJE/WS support for these systems is 
described in publications listed in the 
section "IBM System/3 and System/32 as 
Remote Stations." 
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IBM System/360 and System/370 as Remote Stations 


The following sections contain instructions 
for operating any model of System/360 or 
Systen/370 equipped for EBCDIC transmission 
and binary synchronous communications, as a 
HASP MULTI-LEAVING remote station. The 
term System/360 is used tc refer to both 
the System/360 and the System/370. 


CONFIGURATION SPECIFICATIONS 


Any System/360 with 8K or 
main storage, a supported transmission 
control unit, and a supported card reader 
may be used as an RSCS remote station. 


more bytes of 


The following transmission control units 


are supported: 


e Integrated Communications Adapter (ICA) 
on the System/370 Model 135. 


e IBM 2701 Data Adapter Unit with 


Synchronous Data Adapter Type II. 


e IBM 2703 Transmission Control Unit with 
Synchronous Terminal Control. 


e IBM 3704 Communications Controller in 


emulation mode only. 


e IBM 3705 Communications Controller in 


emulation mode only. 


The following unit record devices are 


supported: 


e IBM 2520 Card Read Punch 
e IBM 1442 Card Read Punch 
e IBM 1403 Printer 
e IBM 1443 Printer 
e IBM 3203 Printer Model 4 
e IBM 3211 Printer 


e IBM 3203 Printer Model 4 (for System/370 
Models 138 and 148 only) 


e IBM 1052 Printer-Keyboard 


Communications lines (switched or 
nonswitched) whose speed is compatible with 


the hardware are supported. Only one 
console, the standard operator console, is 
supported on each remote station. 


A special program for the IBM System/360 


allows it to operate as a remote 
workstation for MULTI-LEAVING operating 
systems such as HASP and ASP. For details 
on generating the appropriate workstation 


program, see the publication OS/VS2 HASP II 
Version 4 System Programmer's Guide, Order 
No. GC27-6992. An IBM System/360 under 


control of this program and communicating 


With RSCS can be viewed as a _ logical 
extension of the VM/370 spool system. This 
program (HASP/R TP 360) performs input, 


output and communication functions. 


HASP/RTP360 can read, print, and punch 
data concurrently, depending on the options 
selected by the installation and the 
capabilities of the unit record devices. 


Due to the use of blocking and character 
compression to minimize line transmission 
time, the speed at which the System/360 
unit record devices operate is dependent on 
the data being transmitted and the number 
of concurrent functions. Certain job 
mixes, because of their data 
characteristics, enable HASP/RTP360 to 
operate the unit reccrd devices at near 
maximum speed. Other job mixes may cause 
the devices to operate in short bursts 
because of contention on the communications 
line. 


INPUT FUNCTIONS 


HASP/RTP360 provides the following input 


functions at the remote station: 
e Reads from the attached card reader(s). 


e Recognizes operator requests, and reads 


from the attached console. 


Identifies, compresses, and blocks card 
images and commands for transmission to 
RSCS. 

e Queues blocked records for transmission 
to RSCS. 
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OUTPUT FUNCTIONS 


HASP/RTP360 provides the following 
functions at the remote station: 


output 


* Degueues blocked records received from 
RSCS. 

e Identifies the device required for 
output of the records. 

e Deblocks and decompresses output 
records, queueing the images for 
printing, punching, or typing. 

e Prints, punches, and types the output 
records, as required. 

e Sets status flags, indicating backlog 


conditions on the output devices. 


COMMUNICATION FUNCTIONS 


HASP/RTP360 provides the following 
communication functions at the remote 
station: 

e Establishes and maintains 
synchronization with RSCS. 

e Dequeues' blocked input requests and 
transmits them to RSCS (upon request 
from RSCS). 

e Provides backlicg status flags, 
indicating the station's ability to 
receive the various output streams from 
RSCS. 


e Receives output from RSCS and queues the 
blocked records for processing. 


OPERATING PROCEDURES 


The following sections provide information 
for initiating and operating the 
HASP/RTP360 program during the remote job 
stream processing session. 


The initiation of a remote job. stream 
processing session involves initial program 
loading of the HASP/RTP360 program deck, 
establishment of the communication lines, 
and exchange of initial control information 
between RSCS and the HASP/RTP360 program. 
The initial control sequence ends with the 
passing of the sign-on information from the 
remote station. 
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INITIAL PROGRAM LOAD (IPL) 


taken to 
loading of the 


The following steps should be 
perform the initial program 
HASP/RTP360 progran deck: 


1. If the power for 
off, press POWER ON. 


the System/360 is 


2. Ready the HASP/RTP360 deck in reader 1 
(designated by central systen 
personnel) and press START and EOF on 
the reader. (The last card of the deck 
should be blank or a /*SIGNON card, as 
directed by the installation.) 

the 


3. Ready printers, and 


console. 


punches, 


4. Set the LOAD UNIT rotary switches to 
the device address of reader 1. 


5. Disable the interval timer, if 
present. 
6. Set the MODE (RATE) and DIAGNOSTIC 


(FLT) switches to PROCESS. 
7. Set CHECK CONTROL to STOP. 
8. Press SYSTEM RESET and LOAD. 


9. All cards of the HASP/RTP360 deck are 
read by the reader. 


10. HASP/RTP360 prints the /*SIGNON card, 
if present, followed by a RSCS 
environment recording error printout 
(if the contents of core remain 
unchanged since the last run of the 
program). 

11. The remote station is now ready to 
communicate with RSCS. HASP/RTP 360 
waits while communications are 


established with RSCS. 


ESTABLISHING A COMMUNICATION LINE 


The procedures for establishing 
communications with RSCS are as follows: 

1. Ready the data set. This involves 

different actions, based on the type 

of data _ set. Readying nonswitched 


lines only requires that the data set 
DATA button be pressed (if present). 
To ready a dial line data set, perform 
the following: 


a. Press the TALK button, and lift 


the receiver off the data set. 


b. Dial the assigned number for the 


remote station. 


c. If the RSCS line is available, the 
central system answers with a high 
pitched tone. Press DATA and hang 
up immediately; the data set is 
now ready. 


d. If the RSCS line is in use, a busy 
signal is received. Hang up and 
try again later, or dial an 
alternate communication line 
number. 


e. If the call is not answered, the 
RSCS operator has not given the 
necessary command to authorize use 
of that communication line. 
Contact the RSCS Operator and 


request that he issue the START 
command for your link. 
2. When requested by RSCS, HASP/RTP360 


begins the initial control sequence. 


3. When the initial sequence is compiete, 
the sign-on information is transmitted 
£0. ‘RSCS. HASP/RTP360 "handshakes" 
with RSCS until the processing of job 
streams actually begins. 


OUTPUT PROCESSING 


The printing and punching of remote output 


is handled automatically by the RSCS - 
HASP/RTP360 system, except as controlled by 
the remote station Operator or RSCS 
operator, via commands to RSCS. 

INPUT PROCESSING 

With the exception of 2520 and 1442 
combination reader/punch devices, input 
submission can be initiated at any time 
from any card reader supported by the 


HASP/RTP360 program. Multiple readers may 
be used concurrently. Place the cards in 
the input hopper, and press reader START. 
When all of a input stream has been loaded 
into the hopper, press reader EOF to allow 
the reading of the last cards to signal the 
program that the end of stfeam has been 
read. 


HASP/RTP360 input readers are considered 
always “hot;" that is, the program is 
continually testing each reader and 
attempting to read cards. When any card 
reader is loaded, HASP/RTP360 immediately 
reads and transmits the cards to RSCS. 


OPERATING A COMBINATICN CARD READ PUNCH 


Devices with single card paths for both 
read and punch functions are termed 
combination reader/punches if they are 
supported for both functions. The following 


are supported combination devices: 
e 1442 Card Read Punch 
® 2520 Card Read Punch 


[ual devices have four basic status 


conditions that affect the operator: 


1. Neutral -—- reader 
program execution. 


empty during normal 


2. Input -—- reading normal input stream. 

3. Output -- punching normal output from 
RSCS. 

4. Output error recovery -- attempting to 


recover from punch errors. 


All IPL time, the combination device is 
in neutral status and may be treated as any 
reader device, since the operatcr is at 
literty to sutmit multiple input streams at 
any time. Any blank cards mixed in the 
input stream are sukmitted to RSCS as 
input. When HASP/RTP360 recognizes the 
end-of-file (EOF) the combination device 
reverts to the neutral status. 


When the combination device is in 
neutral status, the operator may choose to 
ready the device with blank cards, placing 


the device in output status. If RSCS has 
output Waiting, HASP/RTP360 responds 
immediately Fry punching the blank cards. 


However, after all punching is finished, or 
if there is a pause due to low line speeds, 
the operator may not run the remaining 
cards out of the device and ready it with 
jor strean cards. The procedure for 
interrupting the output mode is as follows: 


1. Press STOP on the device. 
2. Remove the cards from 


not run the cards 
path.) 


the hofrper. (Do 
out of the card 


3. Place the input stream cards in the 
hopper, and press reader START. 

4. If the busy, the device 

until the input 

then, the 

(It is not 

cards be 


punch is 
continues punching 
stream is encountered; 
device enters input status. 
necessary that all blank 
removed from the hopper.) 


5. If the punch is 
operator can cause the 


momentarily idle, the 
device to pass 
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one card through by pressing reader 
STOP and then START. If several blank 
cards are inthe hopper in front of 


the job stream, the operation must be 
repeated for each blank card. 


is in error 
punch error occurs. 


The combination device 
recovery status when a 
HASP/RTP360 attempts to repunch the record 
in error into the following card. If 
HASP/RTP360 encounters a punched card, a 
read error occurs (see unit record error 
procedures). The operator should run out 
the input stream cards using the NPRO key, 
place one or more blank cards in front of 
the input stream, and ready the device. 


ENTERING COMMANDS 


SS ee ee ee ee ee 


All commands entered into the 1052 
operator's ccnsole via the keyboard are 
transmitted to RSCS for action. Although 
all commands transmitted to RSCS are listed 
on the RSCS operator's console, only those 
available tc the remote user are read and 


acted upon. 


The operator should perform the 


following stefs when entering commands: 


1. Press the REQUEST button on the right 
side of the keyboard. The ATIN 
indicator (indicator above the 
key board on the 1052) glows 
momentarily. 

2. When the PROCD indicator comes on, 
type in the command and press’ EOB 
(numerical 5 key pressed while ALTN 
CODING key is depressed). 

3. If a typing error is noticed prior to 
pressing EOB, press CANCEL (numerical 
0 key pressed while ALTN CODING is 
depressed) and repeat step 2. 

4. If, after receiving a PROCD indicator, 
no command is to be entered, press 
EOB. 

ENTERING COMMANDS FROM CARDS 

To send commands to RSCS from a ecard 
reader, punch the commands, one per card, 
starting in column 1. Put one or more 


commands cards, followed by a /*EOF card, 


into an available card hopper and press 
START. The commands are transmitted along 
with the remote station number and reader 


humber to the RSCS operator's console. 
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The /*EOF control card consists cf the 
characters "/*EOF® punched in columns 1-5. 
This control card must be the last card 
read, whether decks, commands, or just a 
/*SIGNOFF card is being read. This card 
may optionally be used on the 1442 Card 
Read Punch, but the recommended 1442 


precedure is as stated previously. 


The EOB control card consists of the 
characters "EQB"® in card columns 2-4 It 
is used instead of the /*SIGON card when 
the default /*SIGNON card, assembled into 
the HASP/RTPSYS3 deck, is not to be 
overridden. 

TERMINATING A SESSION 


To terminate remote processing, the remote 
station operator should enter a DRAIN 
command or a /*SIGNOFF card which prevents 
RSCS from initiating any more remote cutput 
and releases the communication line (if 
switched) when the current print and punch 
streams are finished. The DATA light on the 
data set goes out and BSCA enters a check 
condition. For nonswitched lines, RSCS 
makes the line availakle and waits for an 
initial sequence request from the 
HASP/RTP360 program. HASE/RTP360 logs UNIT 
CHECK on the console message device. The 
Operator should determine whether printing 
and punching of output strears have 
successfully terminated and should fress 
console STOP. 

To start a new session, the 
must perform the steps 
previously, starting with the 
Program Load of HASP/RTP360. 


operator 
described 
Initial 


The following sections indicate some ccmmon 


error conditions and the necessary steps 
for recovery from the errors. 

COMMUNICATION ADAPTER ERRORS 

Due to the design of the synchrcnization 
technique for RSCS remote stations, no 
errors are expected during a processing 
session. The unusual occurrence, therefore, 
of any error condition results frem either 
systen Or communication facility 


malfunction or from operational conditions. 
In general, the display of error messages 
is only informational, because the station 
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processor automatically initiates the 
appropriate recovery action. 


A statistical summary of all errors is 
maintained in the RSCS Environmental 
Recording Table, and a historical report is 
produced each time HASP/RTP360 is loaded, 


unless storage has been cleared. 
Additionally, the occurrence of any error 
causes a descriptive message to be 


displayed immediately on the console 
typewriter. 


Figure 4 indicates each possible 
coOmmunicaticn error, its meaning, and the 
recovery acticn taken. 


August 31, 
UNIT RECORDED ERRORS 
Many of the unit record device errors 
can Occur during processing 


19977 


HASP/SRTP360 to continue processing without 
Operator intervention. Some errors (such as 
CATA check, END OF FCRM, etc.) reguire 


operator assistance tkefore use cf 


the 


device can ke continued. In any event all 
errors occurring on unit record devices are 
logged in the RSCS Environmental Recording 
Error Printout Table and are displayed 
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De aod 


immediately on the 1052 operator's 2. Note the device status; if HASP/RTP360 
console. continues to use the device, the error 
message is informative in nature. 
When the error message is printed, the 
operator should perform the following: 3. Correct the error in accordance with 
procedures prescribed for the device. 
1. Determine which device is in error 


(see Figure 5). 4. Ready the device to resume operation. 
SSeS eT SS 
| Error 1 Description i Recovery Action | 
| -___-_______________________—__—_—__—_-—_—-k eee ee nee | 
{ Olrree00 Block sequence check. A transmission check If a duplicate, the received| 


1 | 

| was duplicated or lost. {| block is ignored. If a lost| 
| rr received block number | block, RSCS is signaled to j 
| ee expected block number | Testart the job. 


er ETE RN 


| 02000000 | Negative reply received. A transmission block| The bad record is 


| j was not correctly received by RSCS. {| retransmitted. 

| cc ci i cu im iw: ese i ere ee ee Seni ne is etn es —_ a aca 

| O3rrrr00 | Unknown response received. An unrecognizable | RSCS is requested to 
control character was received from RSCS. | retransmit the record. 


is correct sequence, ending sequence | 
was bad). | 


| 

| 

| 

I 

ni pc ie pcs tt eo am ic cc gigs cami toro aans | 

| 

| | { 
| | cwrrr = first two characters received (if rrrr| | 
| | ! 
| | | 


04000000 | Unit exception. Indicates receipt of an EOT | RSCS is requested to | 
| character from RSCS (EOT is not utilized in | retransmit the record. | 
| MULTI-LEAVING). | | 

—— Ori ee ae rte aa aanameen, 

| 
: 


{| rejected by the Synchronous Data Adapter. 
| 


Figure 4. HASP/RTP360 Communication Adapter Error Messages 


| 

| 

1 

| 

| O5ss0000 | Unit check. A check condition has occurred in| The failing operation will 

| | the communication adapter. { be retried. If a write 

| | ss = sense byte indicating type of check: | Operation was in process at | 
i | | the time of error, the write| 
| | 80 = Command reject | will be reissued; otherwise, | 
| | 4Q0 = Intervention required {| RSCS is requested to | 
| | 20 = Bus out check | retransmit. | 
| | 10 = Equipment check | | 
| | 08 = Data check { | 
| | 04 = Overrun i ! 
| | 02 = Lost Data | | 
| | 01 = Time out | | 
(= i i ee i 
j O06ccO000 | Unusual end. An unusual end condition has | The failing operation is | 
| j occurred in the channel or control unit | retried. | 
| | interface. | | 
| | cc = CSW byte 5 | | 
I- SS ee ee ee | 
| | | | 
i 07000000 | SIO failure. A start I/O instruction was | The Start I/O is retried. | 
| | | 
Le 
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I 1 
| end. IBM customer engineer should he | 
| consulted. | 
| cc = CSW byte 5 | 
| aaa = device address | 


ene 


Note: Printing on a line that has a carriage control tape channel 9 or 12 punch 
appears as an error and is logged as an error. The installation should place these 
punches in line positions that do not contain print information. Do not eliminate 
the punches from the carriage tape. 


ae ee a 

| Message | Description | Program Action | 
| ae ne ee are ee cere cea ca en nana 

| O5ssOaaa | Unit check. Device with address "aaa" has | 

{ | unit check error described by sense byte "ss"| | 

I 1! and/or indicator lights con the device i | 

| | console. | | 

| | 1 | 

| | Sample sense byte settings: { | 

I | | | 

| | 4Q0 = Intervention required {| Wait for operator. | 

| | 10 = Equipment check | Treat as data check. | 

| | 08 = Data check — card read, card | Depending on device: | 

| | punched, or line printed {| ignore, retry, or wait for | 

| | incorrectly. | operator. | 

| 1 01 = Carriage control tape channel 9 {| Ignore. | 

| | encountered on printer | | 

Se ee | 

O6ccOaaa Unusual end. Previous I/O came to an unusual Treat as data check. I 

I 

| 

| 

| 

| 

| 

| 

| 

| 


I 
| 
| 
| 
| 
| ee eee 
| 
{ 
I 
| 
L 


etiam ‘heii ial inst ini osc ia a aed ge a a TE | 
Figure 5. HASP/RTP360 Unit Record Error Messages 
REMOTE STATION RESTART 2. Determine, from the RSCS_ operator's 
record, which deck was currently being 
transmitted to RSCS. The input 
In the event of an untimely interruption of stream, starting with that current 
the remote station operation (such as a deck, must be submitted to RSCS after 
machine, prcogran, communications, or restart. 
environmental failure), the remote station 
operator should notify appropriate support 3. Determine the loss of data on _ the 
personnel of the malfunction, save material output devices and inform the RSCS 
that can be used to determine the source of operator to backspace or restart the 
the failure, and prepare to restart the printer or punch, as necessary. (The 
Station as follows: RSCS link should be made available for 
a subsequent session with the remote 
1. Notify the RSCS operator of the station or other stations within the 
failure and, if necessary, request his system.) 


assistance in preparing for restart. 
4. When the remote station is available, 
restart the sessicn beginning with the 
Initial Program Load of HASP/RTP360. 


tien, 
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IBM System/360 Mode! 20 and IBM 2922 as Remote Stations 


The following section contains instructions 
for cperating the IBM System/360 Model 20, 


equipped with a Binary Synchronous 
Communications Adapter, or the IBM 2922 
Programmable Terminal as a RSCS 
MULTI-LEAVING, remote station. All 


information on the Model 20 also applies to 
the IBM 2922 unless a variation is noted. 


CONFIGURATION SPECIFICATIONS 


Any submodel of the Model 20 with at least 


8K kbytes of main storage, a Binary 
Synchronous Communications Adapter, EBCDIC 
transmission, Full Transparency, and a 


suppcerted card reader may be used as a RSCS 
remote station. 


The following unit record devices 
supported in any combination: 


are 


e IBM 2501 Card Reader 
e IBM 2520 Card Read Punch 
e IBM 2560 Multifunction Card Machine 
e IBM 1442 Card Punch 
e IBM 1403 Printer 
e IBM 2203 Printer 
e IBM 2152 Printer-Keyboard 
Messages from the RSCS operator are sent 


to the System/s360 Model 20 console when one 
is on line; however, when there is no 
console, the messages are sent to the Model 
20 printer provided the printer is not 
busy. The RSCS operator messages are lost 
when there is no Model 20 console and the 
printer is busy? RSCS is unable to 
determine whether or-not the Model 20 has a 
console or the state of the printer. 


Any speed communication line 
by the hardware (switched or nonswitched) 
is supported. It is recommended (but not 
required) that a submodel 5 be used in 
conjunction with high-speed communications 
lines (19,200 bps and greater) for maXimun 


supported 


performance, Certain other features of the 
Model 20 that are supported but are not 
required include: 

e 2152 Printer-—Keyboard. Cannot be used 


on other than a submodel 5 if a 


high-speed communications line (19,200 
bps or greater) is used. 
The IBM 2922 is supported as a_ RSCS 


remote station with the same package as is 
used with the Model 20. The standard 2501 
Card Reader and 1403 Printer available with 
the 2922 are the supported input and cutput 
devices. . 


A special program for the IBM System/360 
Model 20 andthe IBM 2922 Programmable 
Terminal allows them to operate as remote 
workstations for MULTI-LEAVING operating 
systems such as HASP and ASP. For details 
On generating the appropriate workstation 
prcegram, see the puklication OS/VS HASP II 
Version 4 System 


= Sh ee Se ee 


No. GC27-6992. A Model 20 or IBM 2922 
under control of this program and 
communicating with RSCS can be viewed as a 
logical extension of the VM/370 spool 
system. This program (HASE/RTPM20) 
performs input, output and communications 


functions. 


HASP/RTPM20 can tread, print, and punch 
data concurrently, depending on the oftions 
selected by the installation and the 
capabilities of the unit record devices. 


Tue to the use of blocking and character 
compression to minimize line transmission 
time, the speed at which the Model 20 unit 
record devices operate is dependent on the 
data being transmitted and the number of 
concurrent functions. Certain job mixes, 
because of their data characteristics, 
enable HASP/RTPM20 to operate the unit 
record devices at near full speed. Other 
jok mixes may cause the devices to oferate 
in short bursts because of contention on 
the communications line. 


INPUT FUNCTIONS 


HASP/RTPM20 provides the following 
functions at the remote staticn: 


input 


* Reads from the attached card reader(s). 
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e Recognizes operator requests, and reads 


from the attached console. 


e Identifies, compresses, and blocks card 
images and commands for transmission to 
RSCS. 

e Queues blocked records for transmission 

to RSCS. 


OUTPUT FUNCTIONS 


HASP/RTPM20 provides the following 
functions at the remote station: 


output 


e Dequeues blocked records received from 


RSCS. 


e Identifies the device 
output of the records. 


required for 


e Deblocks and decompresses output 
records, queueing the images for 
printing, punching, or typing. 


e Prints, punches, and types the output 
records, as required. 

e Sets status flags, indicating backlog 
conditions on the output devices. 

COMMUNICATION FUNCTIONS 

HASP/RTPM20 provides the following 

communicaticn functions at the remote 

station: 

e Establishes and maintains 


synchronization with RSCS. 


e Dequeues blocked input requests) and 
transmits them to RSCS (upon request 
from RSCS). 

e® Provides backlceg status flags, 


indicating the station's ability to 
receive the various output streams from 
RSCS. 


e Receives output from RSCS and queues the 
blocked records fer processing. 


OPERATING PROCEDURES 


ee ee cee ee ee ee ae ee ee ee ee ee 


This secticn provides 
starting and cperating the 


information for 
Model 20 or IRM 


2922 during the remote job stream 
processing sessicn. 
The initiation of a remote job stream 


processing session involves initial program 
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loading of the HASP/RTPM20 program deck, 
establishment of the communication lines, 
and exchange of initial control information 
between RSCS and the HASP/RTPM20 progran. 
The initial control sequence ends with the 
passing of the sign-on information frcom the 
remote station. 


INITIAL PROGRAM LCAD (IPL) 


The following steps should be 
perform the initial prcegran 
HASP/RTPM20 program deck: 


taken to 
loading cf the 


1. If the power is off, press POWER ON. 
2. Ready the HASP/RTPM20 deck in the 
supported card reader. (The last card 
of the deck should be blank or a 
/7*SIGNON card, as directed by the 
installation). 


3. Ready the printer, 
(as required). 


punch, and ccnsole 


4. Set time sharing key down. 


5. Set the address/register data switches 
to one of the following: 


1F00 — 8K storage 
2F00 - 12K storage 
3F00 - 16K storage 


6. Set the mode switch to PROCESS. 

7. jPress LOAD. 

8. All the cards in the HASP/RTEM20 deck 
are read, except the last card. Press 
reader START to read the last card. 

9. The IPL is complete when the last card 


is read. HASE/RTPM20 prints the 
/*SIGNON card, if present, fcllowed by 


a RSCS environmental recording error 
printout (if the contents of main 
storage remain unchanged since the 


last time the program was run). 


10. The BSCA indicator lights shceuld show 


periodic transmit and receive 
activity. 
11. The remote station is now ready to 


communicate with RSCS. 


ESTABLISHING A COMMUNICATION LINE 


The procedures for establishing 
communications with RSCS are as follows: 


1. Ready the data set. This involves 


GC20-1816-1 and -2, Fage 


based on the type 

nonswitched 
the data set 
pressed, if 
dial line data 


different actions, 
of data set. Readying 
lines cnly requires that 
DATA Fushbutton be 
present. Toc ready a 
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set, perform the following: 


a» Press the TALK pushbutton, 
lift the receiver off the 
set. 
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b. Dial the assigned number for the 


remote station. 


c. If the RSCS line is available, the 
central system answers with a high 
pitched tone. Press DATA and hang 
up immediately; the data set is 
now ready. 


d. If the RSCS line is in use, a busy 
Signal is received. Hang up, and 


try again later, or dial an 
alternate communication line 
number. 

e. If the call is not answered, the 


RSCS operator has not given the 
necessary command to authorize use 
of that communication line. 
Contact the RSCS operator and 


request that he issue the START 
command for your link. 
2. When requested by RSCS, HASP/RTPM20 


begins the initial control sequence. 


3. When the initial sequence is complete, 
the sign-on function is transmitted to 
RSCS. HASP/RTPM20 "handshakes" with 
RSCS until the processing of job 
streams actually begins. 


OUTPUT PROCESSING 


The printing and punching of remote output 
is handled automatically by the RSCS - 
HASP/RTPM20 system, except as controlled by 
the remote station Operator or RSCS 
operator, via commands to RSCS. 


INPUT PROCESSING 


Deck submission can be initiated at any 
time, depending on the capabilities of the 
card reader/punch combination attached to 
the Model 20. There is no restriction on 
when the operator can submit a deck strean 


with the following reader/punch 
combinations: 
a@ Reader - 2560 Multi-function 


1. 2501 Car 
Card Machine (secondary feed) 


2. 2501 Card Reader - 1442 Card Punch 
3. 2501 Card Read - 2520 Card Punch 


Multi-Function Card Machine 
1442 Card Punch 


4. 2560 
(primary feed) - 


5. 2520 Card Read Punch - 1442 Card Punch 


The operator places the cards in the 
hopper. The reader stops just before 
reading the last card of each job stream. 


The operator should put more cards in the 
reader or press START on the reader, 


allowing the last card to indicate the end 


of the input stream. 

The input reader to HASP/RTPM20 is 
always considered "hot;" that is, the 
program is continually testing the reader 
and attempting to read cards. During this 
time the appropriate CARD I/0 indicator on 
the CPU console is on (see Unit Record 
Error Procedures). This condition is not an 
error but indicates that HASP/RTPM20 is 
ready to send the next input stream. 


OPERATING A COMBINATION CARD READ PUNCH 


Devices with single card paths for both 
read and punch functions are considered 
combination reader/punch devices. When 


uSing these devices as combination devices, 
the operator must concern himself with the 
status of the device. The following are 
supported combination devices: 


e 2520 Card Read Punch 


e 2560 MFCM (read - primary feed) 


{punch - secondary feed) 
Note: These devices are not considered 
combination devices when used in 


combinations listed previously under "Input 
Processing". 


The 2520 Card Read Punch has four’ basic 
status conditions that affect the operator: 

1. Neutral -~- reader empty during normal 
program execution. 


2. Input -- reading normal input stream. 
3. Output -- punching normal from RSCS. 


4. Output Error recovery -- attempting to 
recover from punch errors. 


At IPL time the 2520 is in neutral 
status and may be treated aS any reader 
device; the operator is at liberty to 
submit multiple input streams at any time. 


Any blank cards mixed in the input stream 
are submitted to  RSCS as input. When 
HASP/RTPM20 recognizes an end-of-file 
(EOF), the 2520 reverts to the neutral 
status. 
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When the 2520 is in neutral status, the 
operator may choose to ready the device 
with blank cards, thereby placing it in 
cutput status. If RSCS has output waiting, 
HASP/RTPM20 responds immediately by 
punching the blank cards. However, after 
all punching is finished or if there isa 
pause due to low line speeds, the operator 
may not run the remaining cards out of the 
2520 and ready it with input stream cards. 
The procedure for interrupting the output 
mode is as follows: 


1. Press STOP on the 2520. 
2. Remove the cards from 


not run the cards 
path.) 


the hopper. 
out of the 


(Do 
card 


3. Place the input stream cards in the 


hopper and press reader START. 


4. If the punch is 
continues punching until the input 
stream is encountered; then, the 2520 
enters the input status. (it is not 
necessary to remove all blank cards 
from the hopper.) 


busy, the device 


idle, it 
from the 
operator 
one card 


5. If the punch is momentarily 
is waiting for local commands 
console (if installed). The 
can cause the 2520 to pass 
through by typing on the console 
".SR1" (start reader 1). If several 
blank cards are in the hopper prior to 
the input stream, this command must be 
entered for each blank card. ‘For 
configurations without consoles, the 
operator can simulate the .SR1 command 
by setting data dial 2 to numerical 
value 2 and moving data dial 1 one 
position in either direction. Do not 
move dial 1 twice. Upon completion of 
the skip function, set data dial 2 out 
of position 2. 


The 2520 is in error recovery status 
when a punch error occurs. HASP/RTPM20 
attempts to repunch the record in error. If 
HASP/RTPM20 encounters a nonblank card, a 
read error occurs (see Unit Record Error 
Procedures). The operator should run out 
the input stream cards using the NPRO key, 
place one or more blank cards in front of 
the input stream and ready the 2520. 


The 2560 has two basic status conditions: 


1. Input -- submitting decks using 


primary feed and hopper. 
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2. Output -- punching data from RSCS 


using secondary feed. 


Blank cards, for punching, should always 
be in the 2560 secondary feed hopper during 
normal processing. HASP/RTPM20 
periodicaliy tests the primary feed for 
input stream cards. If input stream cards 
are encountered, the HASP/RTPM20 suspends 
the output status and submits the input 
stream to RSCS. The operator should always 
press STOP on the combination 2560 prior to 


loading the input stream in the primary 
feed hopper since HASP/RMTM20 cycles’ the 
feed mechanism when it tests for input 


stream cards. 


ENTERING COMMANDS 


RSCS commands, as well as_ local commands, 


May be entered at the 2152 operator's 
console. Any message entered at the 2152 
keyboard and not reccgnized as a local 


command is transmitted to RSCS for action. 
Although all commands transmitted to RSCS 
are listed on the RSCS operator's console, 
only those designated as available to the 
remote user are acted upcen. Local commands 
that are available to the HASP/RTPM20 
operator signal the status of the unit 
record devices. Figure 6 contains a list of 
all available local commands. 


----—_- ———. 


{Command | 


pa eer 
MeaningysComments | 
Ge Sas a a a a og ee t 
|Start reader 1. This command | 
tells HASP/RTPM20 that the oper-—| 
ator has corrected a data check | 
condition and has made the card | 
reader ready tc continue reading] 
the input stream (the first card] 
is a corrected version of the 
card in error). This command is 
also used to terminate the out— 
put status of a combination 

2520 card reader/punch. 


-SR1 


-SU1 
HASP/RTPM20 that the operator 
has removed the incorrectly 
punched card from the punch 
stacker (1442) and the punch is 


| 
| 
| 
| 
| 
| 
Start punch 1. This command tells| 
| 
| 
| 
| 
| 


Figure 6. HASP/RTPM20 Local Commands 


The operator should perform the 


foliowing steps when entering commands: 


td as 
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1. Press the REQ pushbutton that is RSCS should not initiate any additional 
located to the right of the console remote output and should release the 
typewriter keyboard. The request communication line (if switched) when the 
indicator (indicator marked "R" at the current print and punch streams are 
right of the REQ pushbutton ) glows finished. The DATA light on the data set 
momentarily. goes out, and BSCA enters a check 
condition. For nonswitched lines, RSCS 

2. When the proceed indicator comes on makes the line availakle and waits for an 
(indicator marked "pu below the initial sequence request frem the 
request indicator), type in the HASP/RTPM20 program. Versicns of 
command and press EOT. HASP/RTPM20 that support console messages 


3. If a typing error is noticed prior to 


pressing EOT, press CAN (cancel) and 
repeat step. 

ie: “LE, after receiving a proceed 
indicator, no command is to be 
entered, type "." and press EOT. This 


is reccgnized as an invalid local 


command and is ignored. 


Commands are identified by 
in the first type position. 
use of upper and lower case alphabetic 
characters, the commands must appear 
exactly as listed. No blanks are allowed. 


a period (.) 
Except for the 


ENTERING COMMANDS FROM CARDS 


card 
card, 
more 
card, 
press 


commands to RSCS 


punch the commands, 


Put 


To send 


roaader 
-wVwUuUur+g 


starting 
commands cards, 


from a 
“a 


ana na 


in column 1. 
followed by a /*EOF 
into an available card hopper and 
START. The commands are transmitted along 
with the remcte station number and reader 
number to the RSCS operator's console. 


The /*EQOF control card consists of the 
characters "/*EOF" punched in columns 1-5. 


This control card must be the last card 
read, whether decks, commands, or just a 
7*SIGNOFF card is being read. This card 
may optionally be used on the 1442 Card 
Read Punch, but the recommended 1442 


procedure is as stated previously. 

The EOR centrol card consists of the 
characters "EOR" in card columns 2-4. It 
is used instead of the /*SIGNON card when 
the default /*SIGNON card, assembled into 
the HASP/RIPSYS3 deck, is not to be 
overriden. 


TERMINATING A SESSION 


the remote 
enter a DRAIN 
indicating that 


To terminate remote processing, 
station operator should 
command or /*SIGNOFF card 


log UNIT CHECK on the console. The operator 


should check to see if printing and 
punching of output streams have 
successfully terminated and should fress 
console STOP. 

To start a new session, the operator 


must perform the steps described previously 
Starting with the Initial Program Load of 
HASP/RTPM20. 


The following sections indicate some cCcmmon 
error conditions and the necessary steps 
for recovery from the errors. 


COMMUNICATION ADAPTER ERRORS 


Tue to the design of the synchrcnization 
technique for RSCS remote stations, no 
errors are expected during a frocessing 
session. The unusual occurrence, therefore, 
of any error condition results frcem either 
a system or a communication facility 
malfunction or from cperational conditions. 
In general, the display of error messages 
is only informational, because the station 
processor automatically initiates the 
appropriate reccvery action. 


A statistical summary of all errors is 
maintained in the RSCS Environmental 
Recording Table, and a historical report is 
produced each time HASP/RTPM20 is loaded, 


unless storage has been cleared. 
Additionally, the occurrence of any error 
causes a descriptive message to be 
displayed immediately on the conscie 
typewriter. 

Figure. 7 indicates each possible 
communication error, its meaning, and the 


recovery action taken. 
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Sete Pa ate, ae | 
Message l Meaning | Action Taken 
O1irree00 | Block sequence check. A transmission block | If a duplicate, the received 

| was duplicated or lost. | block is ignored. If a 
| | lost kLlock, RSCS is 
j [Cr = received biock number j Signaied to restart the 
| ee = expected block number {| strean. 
02000000 | Negative reply received. A transmission block| The tad record is 
| was not correctly received by RSCS. | retransmitted. 
O3rrrr00 | Unknown response received. An unrecognizable | RSCS is requested to 
| control character was received from RSCS. | retransmit the record. 
| | 
| rrrr = first character received (if rrrr is | 
| in correct sequence, ending sequence | 
| was bad). | 
05ss0000 Unit check. A check condition has occurred in| The failing operation is 


retried. If a write 
operation was in progress at 
the time of the error, the 
write is reissued; 
Otherwise, RSCS is 

requested to retransmit. 


the communication adapter. 


ss = sense byte indicating type of check. 


Q 
~ 


= overrun on write 
02 = parity check on write 
81 = overrun on read 
88 = lost data on read 
90 = time out (no response received from 
RSCS in three seconds) 
AO = transmission error 
cO = EOT received 


é 
| 
| 
| 
| 
| 
| 
I 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
I 
| 
| 
| 
{ 
i 
| 
| 
| 
| 
| 
| 
| 
I 
Lt 


oe ee 


Figure 7. HASP/RTPM20 Communication Adapter Error Messages 


UNIT RECORD ERRORS Unit record errors that occur during I/0 
result in various program actions, 
appropriate to the operator message 

As a result of unit record device errors facilities availatle for informing the 

that inhibit IyvO, HASP/RTPM20 continuously operator and the nature cf the error 

tests the device, while performing other encountered. Figure 8 indicates the program 
functions that can continue. The operator action taken for each device suprforted by 
is notified of device error by the the system. When notified of the error via 


processor indicator panel as follows: the 2152 ccnsole, the operator should: 
1. Card Ivo 1 -- 2501 Card Reader 1. Note the address code inthe error 
s message (see Figure 8). 
2. Card Iyo 2 -- 2520 Card Read Punch or 
2560 Multifunction Card Machine 2. Correct the error for "data check." 
3. Card Iyo 3 -- 1442 Card Punch 3. Ready the device for frogram retry of 
Iso. 
4, Printer -- 1403 Printer or 2203 
Printer 4. Type the appropriate command (.SR1, 


-SU1) to signal HASP/RTPM20 that the 
device is ready. 
Indicators on the device control panel 


indicate the nature of the problem. The Without the 2152 console, the program 
operator should correct the error, stops the processor with the address of the 
according to procedures prescribed for the device in the ESTR register. The operator 
device, and then ready the device. sheuld (without delay): 

HASP/RTPM20 automatically resumes use of 

the device. 1. Note the address cf the device in the 


ESTR register. 
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tee 
| Device—Function | 
23014 25205 
2560 — read 


——ae 


3. Read. 


1442 — punch 


ee eee eee ee 


~ 2520, 2560 — 1 1. Select out card in error. | 1. Select out card in error. 
punch | | 

| 2. Repunch record in error. | 2. Repunch record in error. 
2203, 1403 —- | Ignore error. { Ignore error. 
eee | | 
2152 - write 1. Ignore first error. Not applicable. 


device. 


2152 — read 1. Initiate reread. 


device3. 


1Error messages are of the form: 
address of the unit in error. 


2Device addresses correspond to the CPU panel CARD I/O indicator numbers. 


3Console error indicator is cleared by pressing OFF LINE, then ON LINE. 


1 ee ee 
Figure 8. 


2. Press STOP on the indicated device. 


3. Press START on the CPU to allow 


continuation of other functions. 


) 


4H. Correct the error for "data check." 


5. Ready the device for 
r/o 


program retry of 


REMOTE STATION RESTART 


In the event of an untimely interruption of 
the remote station operation (such as a 
machine, progran, communications, Or 
environmental failure), the remote station 


Action with Console 


1. Display error message!. 


| 
| 
{ 
1 2. Wait for .SR1 command. 
| 
{ 


1. Display error message!. 
2. Wait for .SU1 command. 


3. Repunch record in error. 


2. Wait on next attempt to use 


| 
| 
| 2. Wait on next attempt to use 
| 


ee A A A TE A ANP EE A ET 


0500000a UNIT CHECK, where a is the device 


—— ee 


I Action without Console 


1. STOP with device address in 
in ESTR register2. 


2. Reread wher CPU started. 


1. STOP with device address in 
ESTR register2. 


| 
| 
| 
} 2. When CPU started, repunch 
| record in error. 

| 

I 


{ Not applicable. 
| 
I 
i 


HASP/RTPM20 Action on Unit Record I/O Execution Errors 


operator should notify appropriate support 
personnel of the malfunction, save material 
that may be of use in determining the 
source of the failure, and prepare for 
restarting the station, as follows: 


1. Notify the RSCS operator of the 
failure and; if necessary, request his 
asSistance in preparing for restart. 


that was 
(The RSCS 


current job 
RSCS. 


2. Determine the 
being transmitted to 


operator has a record of the deck 
currently being submitted to RSCS.)} 
The input stream, starting with that 


current deck, must be resubmitted to 


RSCS after restart. 
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loss of data on the 
and inform the RSCS 
operator to backspace or restart the 
printer or punch, as necessary. (The 
RSCS link should be made available for 
a subsequent session with the remote 


Determine the 
output devices 
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station or with other stations within 


the systen.) 


When the remote station is available, 
restart the sessicn beginning with the 
Initial Program Load of HASP/RTPM20. 


aE 


The IBM System/3 Models 6, 8, 10, 12, and 
15, and the IBM System/32 are supported as 
remote work stations by RSCS. 


There are two types of MULTI-LEAVING 
Remote Job Entry Work Station (MRJE/WS) 
support for the System/3 and System/32. 
The first, which is for the System/3 Model 
10 card system only, applies to a program 
produced by VWM/370 generation. This 
program is in the form of a card deck, 
which is punched out at the System/3 and 
must be loaded to enable communication with 
the host system. This is described in the 
section "IBM System/3 Model 10 Card Systen 
as a Remote Station." 


The second type of MRJE/WS support runs 


on System/3 Models 6, 8, 10, 12, and 15, 
and on the System/32. This support 
consists of a = group of programs that 


support all System/3 or System/32 input and 
output devices, including disks and tape. 
This support requires the System/3 or 
System/32 System Control Program (SCP) and 
related MRJE/WS programs. 


Information describing MRJE/WS support 
for the System/3 is contained in the 
following manuals, which contain references 
to other System/3 SCP manuals. 


System/3 Models 6, 8, 10, and 12 


IBM System/3 MULTI-LEAVING Remote Job Entry 
Work Station 


Support Reference Manual, Order No. 
GC21-7621 
Program Logic Manual, Order No. 
SY¥21-0544 
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IBM System/3 and System/32 as Remote Stations 


System/3 Model 15 


oe ee es ee ee ames eee er ee ee. 


Support Reference Manual, Order No. 
6C21-5115 
Program Logic Manual, Order No. 
S¥21-05521. 

System/32 
The System/32 is supported with the 


following features: 


-- 5320 System Unit (Any 
B33) 


Model A12 through 


-- Binary Synchronous Communications 


Adapter (#2073) 
-~- System Control Program (5725-SC1) 
Information describing 


System/32 is contained in the 
publications: 


support for the 
following 


IBM System/32 System 


Reference Manual, Order No. 


GC2 11-7593 


IBM System/32 Operator's Guide, Order No. 


GC21-7591 


IBM System/32 Data Communications 


Manual, Order No. SY21-0551 


Logic 
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IBM System/3 Model 10 Card System as a Remote Station 


The following section contains instructions 
for operating the IBM System/3 Model 10 
card system, equipped with a Binary 
Synchronous Communications Adapter, as an 
RSCS MULTI-LEAVING remote station. 


CONFIGURATION SPECIFICATIONS 


The Systen/3 
features, is 
MULTI-LEAVING 


Model 10, with 
supported as 
workstation. 


the following 
a RSCS remote 


The minimum System/3 requirements are: 


e 5410 Central Processing Unit (any model) 


e Binary Synchronous Communications 
Adapter 

e EBCDIC Transmission code 

e Text Transparency 

e 5424 Multi-function Card Unit (any 
model) 

e 5203 Printer (any model) 

Supported features are: 

e 1442 Card Read Punch (RPQ 843175 on 


System/3 5410 CPU and RPQ 841205 on 1442 
Card Read Punch) 


e 5471 Printer Keyboard or 5475 Data Entry 
Keyboard 


e Universal Character Set on the 5203 


Printer 


e Additional Print positions for the 5203 


Printer 

e Any type or speed transmission line 
available for the System/3 

Recommended features are: 

e 24 or 36 extra print positions on the 


5203 Printer (to provide standard VM/370 
print line) 


wee ee REN semc off 
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® Universal Character Set and PN train on 


the 5203 Printer (to provide for 
standard vVM/370 character set) 
e 5471 Printer-Keyboard (as a remote 


operator console) 


The following features are incompatible 


with VM/370 support and should not be 
specified: 
e Multi-Point Network Attachment (#9482) 


e USASCII Transmission Code (#9061) 
e Station Selection (#7477) 


All features not specifically prohibited 
may be attached to the System/3 but are not 
supported by the HASP System/3 station 
processor program. 


There is a special program for the IBM 
System/3 Model 10 card system that allows 
it to operate as a remote workstation for 
MULTI-LEAVING operating systems such as 
HASP and ASP. For details on generating the 
appropriate workstation program, see the 
Version 4 


System/3 under control of this program and 
communicating with RSCS can be viewed as a 
logical extension of the VM/370 spooling 
system. This program (HASP/RTPSYS3) 
performs input, output, and communications 
functions. 


HASP/RTPSYS3 can read, print, and punch 
data concurrently, depending on the options 
selected by the installation and the 
capabilities of the unit record devices. 


Due to the use of blocking and character 
compression to minimize line transmission 
time, the speed at which the System/3 unit 
record devices operate is dependent on the 
data being transmitted and the number of 
concurrent functions. Certain job mixes, 
because of their data characteristics, 
enakle HASP/RTPSYS3 to operate the unit 
record devices at near full speed. Other 
job mixes cause the devices to operate in 
short bursts because of contention on the 


communications line. 


aan 


at Pi, 


INPUT FUNCTIONS 


HASP/RTPSYS3 provides the following 
functions at the remote station: 


input 


e Reads from the attached card reader (s). 
e Recognizes operator requests, and reads 
from the attached console. 


e Identifies, compresses, and blocks card 
images and commands for transmission to 
RSCS. 

e Queues blocked records for transmission 

to RSCS. 


OUTPUT FUNCTIONS 


HASP/RTPSYS3 provides the following output 

functions at the remote station: 

e Degqueues blocked records received from 
RSCS. 

e Identifies the device required for 

output of the records. 


e Deblocks and decompresses output 
records, queueing the images for 
printing, punching, or typing. 


e Prints, punches, and types the output 
records, aS required. 

e Sets status flags, indicating backlog 
conditions on the output devices. 

COMMUNICATION FUNCTIONS 

HASP/RTPSYS3 provides the following 

communications functions at the remote 

station: 

e Establishes and maintains 


synchronization with RSCS. 


e Degqueves blocked input requests and 
transmits them to RSCS (upon request 
from RSCS). 

e Provides backlog status flags, 


terminal's ability to 
output streams fron 


indicating the 
receive the various 
RSCS. 


e Receives output from RSCS and queues the 
blocked records for processing. 


ROCEDURES 


—<— 


This section describes normal operation 
procedures for the System/3 as a Remote Job 
Entry station. To start a Remote Job Entry 


session, the operator should load the 
Remote Station Processor (HASP/RTPSYS3) 
program deck, establish a connection 


between System/3 and 
and sign on. 


the central computer, 


INITIAL PROGRAM LOAD (IPL) 


either a 
deck of 


The HASP/RTPSYS3 program deck is 
deck of 96-column cardS or a 
80-column cards. 


To load the 96-column load deck: 


1. Put the deck in the rightmost card 
hopper of the MFCU. 

2. Press START on the MFCU. 

3. Press PROGRAM LOAD on the System/3. 
(For disk systems, the program load 


selection now must point to MFCU.) 


4. Press START on the printer. 


To load the 80-column load deck: 


1. Raise the CE controls cover on the 


Systen/3. 


2. With the CE Mode Selector at PROCESS, 
press SYSTEM RESET. 


3. Turn the CE Mode Selector to ALTER 
STOR. 
4. Set the data knobs to C2, and press 


START once. 


5. Set the data knobs to 01, and press 
START once. 


6. Set the data knobs to 00, and press 
START once. 


7. j%Set the data knobs to 00, and press 
START once. 


8. Set the data knobs to 31, and press 
START once. 


9. Set the data knobs to 54, and press 
START once. 


10. Set the data knobs to 00, and press 
START once. 
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11. Set the data knobs to 03, and press 
START once, 

12. Set the data knobs to F3, and press 
START once. 

13. Set the data knobs to 51, and press 
START once. 

14. Set the data knobs to 01, and press 


START once. 


15. Set the data knobs to F1, and press 
START once. 
16. Set the data knobs to 52, and press 


START once. 


7. Turn the CE Mode Selector to PROCESS. 


18. Press SYSTEM RESET. 

19. Close the CE Controls cover. 

20. Put the 80-column load deck in the 
1442. 

21. Press START on the reader, the 
printer, and the System/3. Cards 
begin to be read. 

22. When the reader ready light goes out, 


press START on the reader. 


Midway through the program deck, the 
reader stops reading and the printer starts 
printing the RSCS Environmental Recording 
and Editing Program (HEREP), a standard 
feature of HASP/RTPSYS3. The information 
printed is the content of certain error 
counters; these counters contain a record 
of the unit checks that occurred during the 


last remote station session. If the 
counters have heen destroyed, one line is 
printed: 

HEREP COUNTERS HAVE BEEN ALTERED. 

In any case, progran loading 
automatically resumes after printing is 
complete. 

Program loading has completed 
satisfactorily if, when the cards’ stop 
reading, the console indicator DT TERM 


READY is ON and either the hopper is empty 
or the first card in the hopper is not an 
EOR or /*SIGNCN card. Decks or blank cards 
may be stacked behind the program deck. If 
DDT TERM READY is not ON, the last card of 
the program deck was not an EOR or /*SIGNON 
card, or a card read error occurred. To 
correct a card read error, follow. the 
procedure under halt code F3 in the IBM 
System/3 Card System erator's Guide. 
Ready the hopper, and depress the START key 
(on dual programming systems, the PROGRAM 
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LEVEL ONE if halt 


displayed. 


RESET key) code F3 is 


If the DT TERM READY light is ON and the 
hopper contains an EOR or /*SIGNON' card, 
the operator should remove the cards from 
the primary hopper, press STOP and then 
NPRO on the reader. The card that was 
stacked when NPRO was pressed is either an 
FOR or a /*SIGNON card. Reload the program 
deck, making sure that it ends with either 
the correct /*SIGNON card or a_ single EOR 
card. 


ESTABLISHING A COMMUNICATION LINE 


The next step in initiating a remote 
session is establishing a line connection 
between the System/3 and RSCS. The RSCS 


operator should already have issued the 
RSCS command START linkid, where linkid is 
the location identifier associated with the 
System/3. 


If the communication line is 
nonswitched, make sure that any controls on 
the line's data _ set are in the DATA 
position. The Systen/3 automatically 
establishes communication with RSCS. 


If the communication line 
pick up the data 
and depress 
pushbutton. 


is switched, 

set's telephone handset 
the data set's TALK 
Dial the proper telephone 
number and listen for the ring. When the 
ring is answered (automatically by RSCS) 
you will hear a high-pitched tone, followed 
by silence. Press the data set's DATA key 
and hang up the handset. The Systenm/3 
initiates communicaticns with RSCS and 
automatically sends it the /*SIGNON card. 
As the /*SIGNON card is being sent, the 
message: 


COMMUNICATIONS ESTABLISHED 


prints on the 5471 Printer-Keyboard and on 
the 5203 Printer (if the 5203 is ready). 


If the System/3 has the Auto-Call 
feature and the /*SIGNON card (or the 
default /*SIGNON card, if not overridden) 
specifies a telephone number, leave the 
data set in AUTO. The Systen/3 
automatically dials the required telephone 
number. When the number anSwers, the 
System/3 automatically signs on. 

If the call is not answered, or if the 
System/3 halts with halt code CA (call 
akorted) while trying to auto-call, the 
trouble is most likely that an incorrect 


telephone number was dialed or specified on 


ae 


the /*SIGNON card. It could also be that 
the RSCS operator did not start the correct 
line. In the latter case, contact the RSCS 
Operator and request that he issue the 
correct START command for your link. 


An auto-~cali halt CA can occur if the 
called number is busy. In that case, 
depress the console START {or PROGRAM LEVEL 
ONE HALT RESET) key to repeat the auto-call 
or redial manually. 


OUTPUT PROCESSING 


The remote operator need oniy press START 
on the printer to allow printing to occur. 
Once a file has reached RSCS, printing 
starts automatically. When a user's 
printed output is complete, RSCS queues 
that user's punched output (if any) for 
processing. 


Notes on the 5203 Printer 


1. At initial program load time, the 
system checks indicators of the 5203 
to determine which print chain is 
mounted. If the indicators show a 48 
Ccharacter-set chain, the systen 
assumes character arrangement LC; 
otherwise, it assumes character 
arrangement PN. 

2. At initial program load time, the 


system sets the number 
per page to 66 


of print lines 
(this may be different 


for each installation). For 
dual-carriage printers, the systen 
uses only the left carriage; the 
Operator must not press the RIGHT 


CARRIAGE RESTORE key. 


3. At initial program load time, the 
systen sets line numbers for 
programmed page skipping. These line 
numbers are provided to simulate the 
carriage tape control normally 
encountered in VM/370. A skip to 
carriage channel 1 results in a page 
eject; a skip to channel 12 stops 5 
lines from the bottom of the page; and 
a Skip to any other channel resuits in 
no page movement. Carriage tape 
channels may, however, be defined 
differently for each installation. 


INPUT PROCESSING 


The remote 
hopper (either 5424 or 


operator places into a card 
1442 card reader) a 


Stack of one or more decks and makes the 
card hopper ready. The system reads the 
first card, finds it punched, and requests 
permission from RSCS to start sending a job 
strean. When the system receives 
permission from RSCS, it continues reading 
cards and sending them tc RSCS. 


If the remote operator 
cn the 
hopper. 
decks must be a 
/*EOF punched into columns 
instructs the systen 
end-of-job-stream indicator to 
make the card hopper dcrmant. 


is reading cards 
5424, he may use either card 
The last card of his stack of 
/*EOF card (the characters 
1-5); this card 


to send an 


ww sae Aaa 


RSCS and to 


If the remote operator is reading from 
the 1442, he ends the job stream by 
pressing START when the hopper is empty. No 
special considerations apply to preparing 
or reading 80-column cards. 


OPERATING A COMBINATION CARD READ PUNCH 


Devices with single card paths for both 
read and punch functions are considered 
combination reader/punches, if they are 


supported for both functions. The following 
are supported combination devices on the 
System/3: 


e 5424 Multi-function Card Unit 
e 1442 Card Read Punch 


1. Either hopper of the 5424 can be used 
as a reader or a punch. When a 
previously dormant 5424 hopper reads a 
punched card, it becomes a reader. It 
remains a reader until it reads a 
/*EOF card; it then goes dormant with 


the /*EOF card in the wait station. 


2. When a previously dormant 5424 hopper 
reads a blank card, it becomes a 
punch. It remains a punch until it 
has completed punching all decks 
queued for it. If no decks are queued 
for it, the operator can make the 
hopper dormant by removing the blank 
cards from it. 


3. The 5424 can read cards much faster 
than it can punch cards; therefore, to 
increase card throughput, the system 
performs card reading preferentially 
over card punching. When using both 
hoppers, one as a reader and one as a 
punch, punching tends to proceed 
intermittently. 
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Though the 5424 has two hoppers, it 
has only one card path. For error 
recovelry purposes, the system ensures 
the card path is empty before 
switching hoppers. Therefore, if the 
operator is using both hoppers as 
readers, or both as punches, the 


system tends to process cards from one 


or the other of the hoppers, rather 
than dividing its time evenly between 
then. 


Each blank card to. be punched is read 
before it is punched, to make sure it 
is blank. A card that is not blank is 
stacked in the read stacker for the 
hopper from which it came. 


Stacker selection is as follows: 


Condition Stacker 
Reading from primary 1 
Punching from primary 2 
Punching from secondary 3 
Reading from secondary 4 


When preparing 96-column cards for the 
input deck, the operator should avoid 
punching column 81, since the systen 
makes special use of this column. In 
any case, the system only transmits 
the contents of columns 1-80; columns 
82-96 are completely ignored. If the 
RMTGEN parameter &S30BJDK was set to 1 


when HASP/RTPSYS3 was generated, the 
system inspects cclumn 81. If that 
column contains the character "1", the 


system assumes that the card contains 
a hexadecimal image of the first 40 
bytes of an 80-column card. It reads 
the next card, checks for a "2" in 
column 81, combines the cards into an 
80-column card image, and transmits 
the card image. No checks are made 
for validity of hexadecimal 
characters. If a "2" card does not 
follow a "1" card, the "1" card is 
ignored. 


restrictions are 
the 5424. For all systems, 
if column 1 is x'6A* (12-11 punch on 
an 80- column card) the systen 
recognizes a RSCS job separator card, 
extracts the spool file number to 
punch a System/3 job separator card, 
and ignores the rest of the card. If 
the RMTGEN parameter &S30BJDK was 
specified as 1 when HASP/RTPSYS3 was 
generated, then the system recognizes 
a card image of an object deck and 
punches two 96-column cards with a 
hexadecinual representation of the 
card; see Item 7 above. If the RMTGEN 
Parameter &S396COL was specified as 1, 


Certain 
placed on 


punching 
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For a detailed 


the system recognizes the left 48 
columns (if column 80 is odd) or the 
Tight 48 columns (if column 80 is 


even) of a 96-column card; in this way 
all 96 columns of a System/3 card can 


be punched. This feature is used to 
create the Systemn/3 Remote Station 
Processor program deck, which is 


punched in System/3 load mode. 


description of the RMTGEN 


macros used in generating the Remote 
Station Processor program, see the OS/VS2 
HASP II Version 4 System Programmer's 


Guide. 


When a previously dormant 1442 reads a 
punched card, it becomes a reader. It 
remains a reader until the operator 
presses the START pushbutton after the 
hopper becomes empty (or until it 
reads a /*EOF card); it then becomes 
dormant. If it became dormant because 
the operator pressed the START 
pushbutton with no cards in the 
hopper, it also runs out the cards in 
its feed path. 


When a previously dormant 1442 reads a 
blank card, it becomes a punch. It 
remains a punch until it has completed 
punching all files queued for it. Only 
after all queued decks have been 
punched can the operator safely remove 
cards from the 1442 hopper; with the 
hopper empty and no more’ punching to 
do, the 1442 becomes dormant. Press 
the NPRO pushbutton to stack the two 
blank cards remaining in the card feed 
path into the right stacker. 


All cards processed by the system are 
stacked into the left stacker. 


ENTERING COMMANDS 


If the System/3 includes 
Key board 
keyboard 
Otherwise, punch the commands 
enter them through a 


a 5475 Data Entry 
5471 Printer-Keyboard, the 

used to enter commands. 
on cards and 
reader, exactly as if 


Or a 
can be 


they were jobs. 


The only 
station are 
described previously under 


from a remote 
RSCS commands 
"Remote Station 


valid commands 
a subset of the 


Operator Commands." 


aii 


ENTERING COMMANDS FROM THE 5471 


PRINTER-KEYBOARD 


RSCS, press the REQ 
can immediately allow 
PROCEED light 


To type a command to 
key. If the system 
you to type a command, the 


goes on; otherwise the REQUEST PENDING 
light goes on. You can press the REQ key 
while you are typing a command, while the 


system is typing a message to you, or while 
the console is dormant. 


When the PROCEED light comes on, start 
typing the command. If you make a mistake, 
press the CANCEL key and start typing 
again. 


When you are finished typing, press 
either the END key or the RETURN key; their 
functions are identical. The command is 
transmitted to RSCS, where it is executed 
(if valid) and printed along with the 
remote station number on the RSCS 
operator's console. 


If the command contains 120 characters, 
the remote station automatically performs 
the END key function when the 120th 
character is typed. 


The 5471 
end-of-forms switch 
runs out of forms, 
REQ key, and then press 
5471 resumes typing if there 
to be typed. 


does not type messages if the 
is on. When the 5471 
reload forms, press the 
the END key. The 
are messages 


ENTERING COMMANDS FROM THE 5475 DATA ENTRY 


KEYBOARD 


To type a command to RSCS, merely start 
typing on the 5475 Data Entry Keyboard. The 
keyboard is always "alive." After the first 
character is typed, the column indicator 
becomes active and displays "02", the 
position of the character to be typed next. 
If you make a mistake, depress the FLD 
ERASE key; the column indicator displays 
"01" and you can start typing again. 


When you are finished typing, depress 
the REL key to transmit the command to 
RSCS. When the column indicators go dark, 


begin typing another command. If you type a 
command of 120 characters, the systen 
automatically performs the REL key function 
when you have typed the 120th character 


ENTERING COMMANDS FROM CARDS 


To send commands to RSCS from ae card 
reader, punch the commands, one per card, 
starting in column 1. Put one or more 
commands cards, followed by a /*EOF card, 
into an available card hopper and press 
START. The commands are transmitted along 
with the remote station number and reader 
number to the RSCS operator's console. 


The /*EOF control card consists of the 
characters "/*EOF" punched in columns 1-5. 
This control card must.be the last’ card 
read by an MFCU hopper when the hopper is 
reading, whether decks, commands, or just a 
/*SIGNOFF card is being read. This card may 
optionally be used on the 1442 Card Read 
Punch, but the recommended 1442 procedure 
is as stated previously. 

The EOR control card consists of the 
characters "EOR" in card columns 2-4. It 
is used instead of the /*SIGNON card when 
the default /*SIGNON card, assembled into 
the HASP/RTPSYS3 deck, is not to be 
overridden. 


SYSTEM/3 LOCAL COMMAND PROCESSING 


If the Systemn/3 Remote Station Processor 
programs include the local command 
facility, you can issue commands to be 
executed locally by the System/3. Placea 
card containing the command into any 
dormant card hopper and press START. Do not 
use a /*EOF card. 


For each 
starts in column 
operand field. 


command, the command name 
1 and is followed by the 


by one 
in the 


Command completion is indicated 
of the following messages, printed 
same place as error messages: 


CODE0000 Command completed satisfactorily 
CODE0001 Syntax error in command 
CODE0002 Operand value error in command 

A /*CARRIAGE command defines printer 
carriage information. The operand field 
has the format: 
yeaa rs aa aa area ta ED | 


| {L=forms—length} {,chan=line—no } | 
[ ,chan=lin-no...] | 
ek ee ay 
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forms-length is the number of print lines 
on a page of forms (it must 


not be greater than 112). 


chan is the carriage-channel 
number (it must be between 1 
and 12). 

line-no is the line number at which 


forms skipping stops for the 
indicated carriage channel 
(it must not be greater than 
forms-length). 


1. The /*CARRIAGE command is effective as 
soon as it is read in. 


2. Specification of the L= operand 
destroys all previous carriage channel 
settings. 


TERMINATING A SESSION 


When you are finished using the Systen/3 as 
a Remote Job Entry station, put into an 
available hopper the two cards: 


/*SIGNOFF 
/*EOF 


and press START on the card reader. 


The /*SIGNOFF card tells RSCS to 
disconnect the communication line after it 
has finished sending the current print and 
punch streams to the System/3 and after it 
has finished receiving the current deck 
from the System/3. That is, RSCS 
disconnects when all currently operating 
functions are complete. If you sign off 
before RSCS_ has started printing or 
punching some, or all of your files, RSCS 
saves the output for transmission to your 
station the next time you sign on with the 
Same remote station identification. The 
DRAIN command can alternatively be used to 
perform the same function. 


When RSCS finally disconnects the 
communication line, the Systen/3 
communication adapter gets a time-out error 
every three seconds for about 20 seconds; 


then the DATA light on the data _ set 
telephone goes out. When the Systen/3 is 
dormant, press the STOP pushbutton on the 
console to stop the customer meter from 
running. The current RJE session is now 
ended. 


User's Guide 


ERROR RECOVERY 


Two general classes of errors are defined 
in the System/3 Remote Station Processor: 
communication record 
errors. For either type of error, the 
system generates an 8-character error 
message. If the system has a 5471 console, 
error messages are typed on it as they 
occur. If the system does not have a 5471 
console, error messageS may or may not be 
printed on the 5203 printer, depending on 
how the Remote Terminal Processor program 
was generated. The format of all error 
messages is; 


: 
+ 
Unit 


ttxxxxuu 


where tt is the message type, xxxx is 
additional error information, and uu is the 
device on which the error occurred. The 
correspondence between uu and device is as 
follows: 


Device uu 
BSCA 00 
1442 05 
5203 OF 
5424 OF 


COMMUNICATION ADAPTER ERRORS 


The communication technique 
prevents BSCA errors 
session. Therefore, any BSCA error that 
occurs while the operator is signed on is 
an unusual condition, resulting from system 
or communication facility malfunction or 
operational ccnditions. For all BSCA errors 
shown in Figure 9, the BSCA processor 
within the System/3 Remote Terminal 
Processor automatically takes corrective 
action. The operator should regard all BSCA 
error messages only as informational 
messages. 


used by RSCS 
during a processing 


UNIT RECORD ERRORS 


Unit record error messages are provided for 
errors on the 1442 Card Read Punch (an RPQ 
device), the 5424 Multi-function Card Unit, 
and the 5203 Printer. 


EE i, 


Crosctcs os oS Pe eR re ig ae ete ec aee Se IRC ee ee ee ee Pag 
| Message | Meaning | Action Taken | 
[=e SS ll 
| O1lrreed0 | A block sequence check occurred. A {Duplicate transmission blocks | 
| | transmission block was duplicated or | are ignored. Lost | 
\ | lost. rr is the received block number | transmission biocks cause j 
i j and ee is the expected block number. { automatic job restart. | 
| | Both rr and ee range from x'80! | | 
| |} to X'8F*. | { 
| 
{| 02000000 | The Systemy3 received a negative {The transmission block that | 
| | acknowledgment (NAK) from RSCS. | was negatively acknowledged | 
| I | is retransmitted. j 
(SS a RS cc | 
| O3rrrr00 | The transmission block received Ly {The System/3 sends a NAK | 
| | the System/3 had an unrecognizable | to RSCS, which then | 
| | starting or ending sequence. The | cetransmits the block. | 
| | starting sequence is rrrr; if it is i | 
| | correct, the ending sequence is in | | 
| | error. | | 
[SSeS ee ee | 
| 05ssss00 | The Systemy3 BSCA has a unit check. The |The appropriate action | 
| | BSCA status indicators are ssss. | is taken to continue or | 
| i | restore communication. | 
| | | i 
| | For example: | { 
H ! | | 
| { 8000 denotes a timeout error | | 
| | 8400 denotes a timeout error with | 1 
| | abortive disconnect | | 
| | | | 
ee fee asic a ect ne i a ahi th ge a pps i ea a mh tl tip eg iat ne die ae | 


Figure 9. HASP/RTPSYS3 Communication Adapter Frror Messages 


5424 Multi-Function Card Unit 


(MFCU) 


The only MFCU error message generated is: 


O5ssssQOF 
where: 
ssss represents the MFCU status 
indicators 
IN all cases, operator intervention is 
required. The operator should check the 
MFCU control panel to determine the card 


hopper to which the error message applies. 


Code Meaning 

PRT The primary (rightmost) card 
hopper needs attention 

SEC The secondary (leftmost) card 


hopper needs attenticn 


The system attemps to perform its previous 
operation when the operator has cleared the 
error condition: if it was reading when an 
error occurred, it tries to read the same 
card again; if it was punching, it tries to 
punch again. Therefore, if the 5424 was 
punching, the operator should throw away 
the last card punched; if the 5424 was 
reading, he should place the last card read 
in the hopper again, so the system can 
reread it. First, however, he must lift 
the cards out of the indicated hopper and 
press the NPRO key to clear the error 
condition. 


The only 5203 error message is O5ssss0E, 
where "ssss" represerts the 5203 status 
indicators. If any error light is on at the 
5203 control panel, the operator must 
correct the condition and press’ printer 
START. The system autcmatically retries 
printing when an incrementer failure or 
print check occurred. 
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The cnly 1442 error message is 0O5ssss05, 
where "sssstt represents the status 
indicators. The system recovers from 1442 


wear 


from AFCU 
perform the 


errors the same way it recovers 
errors. The operator should 
action indicated by the 1442 error lights; 
then, throw away the last card punched or 
place the last card read back in the hopper 


and press START. 


REMOTE STATION RESTART 


In the event of an untimely interruption of 
the remote station operation such as a 
machine, progran, communications, or 
environmental failure, the remote operator 
should notify appropriate support personnel 
of the malfunction, save material that may 
be useful in determining the source of the 
failure, and prepare for restarting the 
station as follows: 
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Notify the RSCS operator of the 
failure and, if necessary, request his 
assistance in prefaring for restart. 


Determine the current deck that was 
being transmitted to RSCS. (The RSCS 
has a record of the current deck being 
submitted to RSCS.) The input stream 
Starting with the current job must be 
submitted to RSCS after restart. 


loss of data on the 
output devices and inform the  RSCS 
Operator to backspace or restart the 
printer or punch as necessary. (The 
RSCS link should be made available for 
a subsequent session with the remote 
station or other stations within the 
systen.) 


Determine the 


When the remote terminal is available, 
restart the session beginning with the 
Initial Program Load of HASP/RTPSYS3. 


The following section contains instructions 
for operating an IBM 1130 System, equipped 


with a Binary Synchronous Communications 
Adapter, aS a RSCS MULTI-LEAVING remote 
station. 


CONFIGURATION SPECIFICATIONS 


a ee es wee ee ee ea ee ee ee ee ee ee 


Any model of the 1130 (except Models 4A and 
4B) with at least 8K words of storage, the 
Synchronous Communications Adapter, and any 
card reader, may be used as a RSCS remote 
station. All standard readers, printers, 
and punches available for the 1130 system 
are supported in any combination. The 
console printer/keyboard is supported as a 
limited remote operator console. Any 
standard communication line {Switched or 
nonswitched) of any speed is supported. The 
RPQ feature that allows the use of 
high-speed communication facilities is not 
Supported. 


A special program exists for the IBM 1130 
that allows it to operate as a remote 
workstation for MULTI-LEAVING operating 
systems such as HASP and ASP. For details 
on generating the appropriate workstation 
program, see the publication OS/VS2 HASP II 
Version 4 System Programmer's Guide, Order 
No. GC27-6992. An 1130 System under 
control of this program and communicating 
with RSCS can be viewed as a logical 
extension of the VM/370 spool system. This 
program (HASP/RPT1130) performs input, 
output and communication functions. 


HASP/RTP1130 can read, print, and punch 
data concurrently, depending on the options 
‘selected by the installation and the 
capabilities of the unit record devices. 


Due to the use of blocking and character 
compression to minimize line transmission 
time, the speed at which the 1130 unit 
record devices operate is dependent on the 
data being transmitted and the number of 
concurrent functions. Certain job mixes, 
because of their data characteristics, 
enable HASP/RTP1130 to operate the unit 
record devices at near maximum speed. Other 
job mixes can cause the devices to operate 
in short bursts because of contention on 
the communications line. 


IBM 1130 System as a Remote Station 


INPUT FUNCTIONS 


HASP/RTP1130 provides the following 
functions at the remote station: 


input 


e Reads from the attached card reader (s). 
e Recognizes operator requests, and reads 
from the attached console. 


e Identifies, compresses, and blocks card 
images and commands for transmission to 
RSCS. 

® Queues blocked records for transmission 

to RSCS. 


HASP/RTP1130 provides the following output 
functions at the remote station: 
from 


e Dequeues blocked records received 


RSCS. 


e Identifies the device 
output of the records. 


required for 


© Deblocks and decompresses output 
records, queueing the images for 
printing, punching, or typing. 


e Prints, punches, and 
records, as required. 


types the output 


e Sets status flags, indicating backlog 
conditions on the output devices. 


COMMUNICATION FUNCTIONS 


HASP/RTP1130 provides the following 
communication functions at the remote 
station: 

e Establishes and Maintains 


synchronization with RSCS. 


e Dequeues blocked input requests and 
transmits them to RSCS (upon request 
from RSCS). 

e Provides backlog status flags, 


terminal's ability to 
cutput streams from 


indicating the 
receive the various 
RSCS. 
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e Receives output from RSCS and queues the 
blocked records for processing. 


OPERATING PROCEDURES 


The following sections provide information 
for initiating and operating the 
HASP/RTP1130 program during the remote job 
stream processing session. 


The initiation of a remote job stream 
processing session involves initial program 
loading of the HASP/RTP1130 program deck, 
establishment of the communication lines, 
and exchange of initial control information 
between RSCS and the HASP/RTP1130 program. 
The initial control sequence ends with the 
passing of the sign-on information from the 
remote station. 


INITIAL PROGRAM LOAD (IPL) 


taken to 
loading of the 


The following steps should be 
perform the initial program 
HASP/RTP1130 program deck: 


1. Ready the HASP/RTE1130 deck in the 
primary card reader (do not place 
decks behind the HASP/RTP1130 deck). 
If two cards readers exist, be sure 
the second is not in ready status. 

2. Ready all printers. 

3. Set the STR/BSC switch to BSC. 

4. Set the line speed control to the 
appropriate value (1200, 2000, 2400, 
etc.). 

5. Verify that the rotary CPU control 
Switch is set to the RUN position. 

6. Press IMM STOP, RESET, and PROGRAM 
LOAD on the 1130 console. 

7. (After the last card has been read, the 


card reader goes out of ready status. 
Ready the card reader (press START on 
the reader until it becomes ready) and 
press START on the 1130 console. The 
last card should be the END card of 
the HASP/RTP1130 deck, a /*SIGNON card 
or a REP card. All unidentified cards 
are ignored. 


8. Establish the communications line. 


Note: The message DATA SET NOT READY 
is printed after the execution of Item 
7 if the data set is not ready and 
establishing the communications line 
is not possible. 


9. Processing can then begin in the full 


MULTI-LEAVING mode. 


ESTABLISHING A COMMUNICATION LINE 


The procedures for establishing 
communications with RSCS are as follows: 


1. Ready the data set. This involves 
different actions, depending on the 
type of data set. For nonswitched 
lines when the BSC RDY indicator is 
on, no action is required. Certain 
nonswitched lines require that the 
data set DATA pushbutton be pressed. 
To ready a dial line data set, perform 
the following: 


a. Press the TALK pushbutton and lift 
the receiver on the data set. 

b. Dial the assigned number for the 

remote station. 


c. If the RSCS line is available, the 
central system answers with a high 
pitched tone. Press DATA and 
replace the receiver immediately 
{the data set is now ready). 


d. If the RSCS line is in use, a busy 
Signal is received. Replace the 
receiver and try again later, or 
dial an alternate communications 
line number. 


e. If the call is not answered, the 
RSCS operator has not given the 
necessary RSCS command (START) to 
authorize use of that 
communicaticn line. Contact the 
RSCS operator and request that he 
issue the START command for your 
link. 


2. When the data set is ready, the BSC 
RDY indicator is on. When requested, 
HASP/RTP 1130 begins the initial 
control sequence. The REC and TSM 
lights alternate during normal 
operation. 


3. When the initial sequence is complete, 
control information is transmitted to 
RSCS and “handshaking" (with the REC 
and TSM lights alternating) continues. 
In addition, the message: 


COMMUNICATION LINE ESTABLISHED 


is printed on the console typewriter. 


Al, 


OUTPUT PROCESSING 


The printing and punching of remote output 
is handled automatically by the 
HASP/RTP1130 system, except as controlled 
by the remote station operator or RSCS 
operator via commands to RSCS. 

Qutput Processing on the 1442 Card Read 
Punch 


A system with the 1442 defined as a 
punch-only device requires no operator 
action other than a ready condition and 
blank cards in the hopper. 


INPUT PROCESSING 


Submission of card decks can be initiated 
at any time, depending on the capabilities 
of the card reader/punch attached to the 


1130 System. 


The 2501 Card Reader allows the cards to 
be placed in the hopper as desired. The 
reader stops after reading the last card in 
the hopper andthe message INTERVENTION 
REQUIRED ON 2507 is printed on the console 
printer. The operator may then press START 
on the reader to terminate the input stream 
or load more cards in the hopper, press 
START and continue the input stream. The 
intervention message is typed whenever the 
2501 goes from a ready condition to a not 
ready condition. 


HASP/RTP1130 is 
that is, it is 
reader and 


The input reader to 
considered always "hot;" 
continually testing the 
attempting to read cards. 


on the 


Input Processing on the Card 


Punch 


1442 Read 


The function of the 1442 Card Read Punch is 
defined via operator action at the 
keyboard/console. Initially, the 1442 Card 
Read Punch is considered to be ae ecard 
reader. When punch data is transmitted to 
the 1130 System, a message is printed: 


PUNCH PROCESSOR WAITING FOR 1442 


The operator may then define the 1442 asa 


punch by entering the command: 


-DPUNCH ( or .DP) 


This specification is 
job that transmits 
station. 


necessary for each 
punch data to the 


Once defined asa 
command 


reader by issuing the 


.DREADER (or .DR) 


the 1442 retains the 
-DPUNCH is given. AS a 
operates in the same manner 
Card Reader. 


assignment until a 
reader the 1442 
as the 2501 


Note that during input processing on the 
1442 Card Read Punch: 


e The .DPUNCH and .DREADER commands resuit 
in no action if the opposite function is 
active at the time the command is 
issued. 


e Defining the 1442 Card Read Punch as a 
punch with input cards in the hopper and 
punch data available from RSCS results 
in the destruction of data in the input 


cards. 


ENTERING COMMANDS 


RSCS commands, as well as local commands, 


may be entered at the remot station's 
console. Any message entered at the 
keyboard, which is not recognized as a 
local command, is transmitted to RSCS for 
action. Although all commands transmitted 
to RSCS are listed on the RSCS operator's 
console, only those designated as being 
available to the remote user are acted 
upon. 


ENTERING RSCS COMMANDS 


The remote station operator should perform 


the following steps when entering RSCS 
commands: 

1. Press the INT REQpushbutton which is 

located to the right of the console 


typewriter keyboard. 


2. When the K.B. Select indicator comes 


on, type in the command, and press 
EOF. 
3. If a typing error is noticed before 


pressing FOF, press the ERASE FIELD 


key, and repeat ster 1. 


Note that the BACKSPACE key is processed 
in the same manner as the ERASE FIELD key. 


Part 4. Spool MULTI-LEAVING Remote Stations 81 


ENTERING LOCAL COMMANDS 


The following local commands can be entered 
at the remote station's console: 


-DR Defi 14uU2 Card 
neh as a reader. This 

remains in effect until a 

is entered and accepted. 


-DP command 


-DP Defines the combination 1442 Card Read 
Punch as a punch. This definition 
remains in effect for one output only. 
The function next assigned is 
dependent on the entering of another 
-DP or .DR. 


identified by a 
period in the first available type 
position. No blanks are allowed in the 
body of a command. Acceptance of a console 
command is signaled by the message: 


Local commands are 


OK! 
Rejection is signaled by the message: 


WHAT? 


TERMINATING A SESSION 


To terminate remote 
station operator can send 


processing, the remote 
a /*SIGNOFF card 


through the card reader input stream or 
issue the CRAIN command. This tells RSCS 
not to initiate the sending of any more 
remote output and to release the 
communication line (if DIAL) when the 
current print or punch strean is 


finished. 
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The RDY light on the data set goes out, 
and an SCA log message Code 3 is released 
periodically. The operator should ensure 
that printing and punching of output 
streams have successfully terminated and 
then press STOP on the CPU. To start a new 
session , the must erform the 


steps described previously, starting with 
the Initial Program Load of HASP/RTP1130. 


Ve Gvuvuaw 


The following sections indicate some of the 
common error conditions that can arise and 
the steps required for recovery. 


COMMUNICATIONS ADAPTER ERRORS 


synchronization 
stations, no 


Due to 
technique 
errors are 
session. The occurrence, 
error condition is an 
resulting from either 
communication facility 
operational conditions. In 
display of error messages is only 
informational, Since HASP/RTP1130 will 
automatically initiate the appropriate 
recovery action. 


the design cf the 
for RSCS remote 
expected during a processing 
therefore, of any 
unusual condition 
system or 
malfunction or 
general, the 


A list of 
displayed on 
in Figure 10. 


that may be 
is shown 


error messages 
the console printer 


tT Sa, 


a ae me ae EE te a 


Te gee ee 5 See ee ae acm reace? | 
j Message | Meaning { Action Taken i 
! pn a a an: aS Soins tam sas an a a a i a i a Sn a a eo ss i 
| FFrree00 | Block sequence check. A transmission block { If duplicate, the received | 
was duplicated or lest. { block is ignored. Tf the \ 
{ block is lost, SHL is { 
| i 

3 


cco 


FY 
i 
: 
3 
i 


i rr = received block number Signaled to restart the job. 
j EE = expected biock number i 
j es sis mete cartes coi ace faa i Sones i ne a ec: Samet i ch a ease wi aera Sil oh Sea Scene wi va j 
{ O2dddd00 ! Abnormai read complete. The number of bytes { SML is requested ta } 
' {| requested have been read, but no end sequence: retransmit the record. | 
| | was detected. j i 
Se SS aa ae ee ar re ee ny 
{| 03dddd00 | Received timeout while attempting to i SML is requested to i 
i j synchronize an initial sequence. { retransmit the record. | 
ctl ah a i ih i tars essa lee scl hice a ee en ce a A ee a oe Me Re ec H 
{ O4dddd00 | Received timeout whiie reading data. | SMHL is requested to | 


| | { retransmit the record. 


OD TN I AP a NP Ege PINE ch 


| OSdddadOO | BCC compare error after normal read complete | SML is requested to 


| { condition. | retransmit the record. 
ij O6ddddO0O | Data overrun error. Program unakle to read | SML is requested to 
| {| data before next character is received from | retransmit the record. 


{ j transmission line. j 


a a ec a Nc GA A 


| HASP/RTP1130 waits for data 
! set to beccme ready and 

| then resumes cperation on 
| 


ee A EE Sc 


O7dddd00 | Data set not ready. Discovered at interrupt 
t 


ime. 


the line. 
| O8dddd0O | Error on initial read. First character not | SML is requested to 
| | SOH, DLE, ENQ, or NAK ...or... SOH-—STX, | retransmit the record. 
{ | DLE-STX, DLE-—ACKO pair not found. | 
ee erence nea rc Ar Ope OR rn sae ncn rn eRe ee NOE Na rR NOE en em Oe ata ae SIE OTS nC nro are 
i o9aaa 60 j NAK received. ! Last data recorded is 
| 


| | retransmitted to SML. 


A ar er cc a eee 


a re ee ce re cee re er te eee mee 


Oe nS le I a RE UY pre 


| OBdddd0O | Single DLE found in transparent data. | SML is requested to 
i | | retransmit the record. 


~ ee ae ey ee re 


{| OCdddd0O {| ENQ received after initial sign-on sequence. { SML is requested to 
| | {| retransmit the record. 


et I A A NE OR NAN NN A A A A A A A A 


A A A ct 


{| OGddddDOO | No pad character following NAK. | SML is requested to 

i | | retransmit the record. 

| ------------- —------------- —_----- | 
{Notes dddd = device status word received for the Synchronous Communication Adapter | 
i a es te ws ei ce ae nein Sn in secs cas scp Sts ess se ls ue asm ea ls ls ec a pis a ee fe cin So ee a mia rnc Sein cou cea eanones Uae 


Figure 10. HASP/RTP1130 Communication Adapter Error Messages 


UNIT RECORD ERRORS When the error mesSage is printed the 
operator should do the following: 

Many of the unit record device errors that 1. Determine which device is in error 

can occur during processing aliow {see Pigure 11}. 

HASP/RTP1130 to continue processing without 

operator intervention. Some errors, such 2. Note the device status; if HASP/RTP360 

as DATA check and END OF FORM, require continues to use the device, the error 

operator assistance before use of the message is informative in nature. 

device can be continued. In any event, all 

errors occurring on unit record devices are 3. Correct the error in accordance with 

logged in the RSCS Environmental Recording procedures prescribed for the device. 

Error Printout Tabie and are displayed 

immediately on the 1052 operator's 4. Ready the device to resume operation. 

console. 
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Message | 


O5ssOaaa | 


_ 
| 
| 
| 
{ 
I 
| 
| 
| 
{ 
| 
l 
I 
| 
| 
I 
| 
i 
| O6ccOaaa | 
{ 

I 

| 

| 


po--- 


Figure 11. 


REMOTE STATION RESTART 


In the event of an untimely interruption of 


ne re ENS nS A A A 


Description 


a 


Unit check. Device with address "aaa" has 


unit check error described by sense byte "ss" 


and/or indicator lights on the device 


Sample sense byte settings: 


40 = Intervention required 

10 = Equipment check 

08 = Data check — card read, card 
punched, or line printed 
incorrectly. 

01 = Carriage control tape channel 9 


encountered on printer 


ee ee ee ee ee 


Unusual end. Previous I/O came to an unusual 


end. IBM customer engineer should be 
consulted. 

cc = CSW byte 5 

aaa = device address 


Oe A A I 


ne ae ne ee ee 


HASP/RTP1130 Unit Record Error Messages 


Treat as data check. 


J 


Program Action 


| 


a 


Wait for operator. 

Treat as data check. 
Depending on device: 
ignore, retry, or wait for 
operator. 

Ignore. 


: 
| 


Note: Printing on a line that has a carriage control tape channel 9 or 12 punch 
appears as an error and is logged as an error. 
these punches in line positions that do not contain print information. Do not 
eliminate the punches from the carriage tape. 


en are ee ee 


| 
The installation should place | 
| 
| 


operator to backspace or restart the 


printer or punch, aS necessary. (The 
RSCS link should be made available for 


a subsequent session with the remote 


the remote station operation (such as a station or other stations within the 
machine, progran, communications, or systen.) 
environmental failure), the remote station 


operator should notify 
personnel of the malfunction. He should 
also save material that may be of use in 


determining the source of the failure and 


prepare for 


follows: 


1. Notify 


restarting the station, as 


appropriate support 4. When the remote station is available, 
restart the sessicn beginning with the 
Initial Program Load of HASP/RTP1130. 


Load Process Unusual Conditions 


the RSCS operator of the 


failure and, if necessary, request his 

assistance in preparing for restart. The first 

station deck comprise a bootstrap loader 

2. Determine the current deck being (RTPBOOT), 
transmitted to RSCS. (The RSCS (RTPLOAD) into upper 1130 storage. RTPLOAD 


operator has a record of the current then loads 


eight cards of the 1130 remote 


that loads the main loader 


the main station deck 


deck being submitted to RSCS.) The (HASP/RTP1130), processes REP cards (if 


input 


current 


strean, starting with that any), and 


deck, must be submitted to included}. 


RSCS after restart. 


Figures 12 


3. Determine the loss of data on the conditions 
devices, and tell the _ RSCS with RTPBOOT and RTPLOAD. 


output 
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processes the /¥*SIGNON card (if 


and 13 describe the unusual 


that may occur in conjunction 


System loop at location 
‘AA with IAR displayed at 


1 

i 

| of colu 
location 'AB*. { 

| 

| 

| 


(checksun) 


73-74, 
during RTPLOAD gen 


— 


— A ne I te 


System loop at location 
"AE' with IAR displaying 
location ‘AF’. AC contains 


card code value 


| 
| EBCDIC punch in RT 
S| 
Value of column i 
in error. | 
| 
| 


just read, or the 
cards of RTPBOCOT 
XR2 contains 2s 
complement of card column 
|} in error. 


L__ 


Figure 12. 


— iti 


eo a ee OC A A ES ED SS ES ES Ste 


RTPBOOT—computed sun 


of last card read does not 
Match value in columns 
previously computed 


RTPBOOT detected illegal 


contain an 
illegal EBCDIC punch. 


HASP/RTP1130 Loading Errors (RTPBOOT) 


Loading of RTPLOAD i 
permanently terminated. 
card being processed, 


mns 1—72 


and 


eration. 


Loading of RTPLOAD is 

permanently terminated. 
card being processed, and 
contact system programmer 


PLOAD card 
last four 


-----5- | ------ 


Note | 


contact system programmer or| 
lead operator about problem. | 


Note] 


ari 
Ory 


lead operator about problen. | 


ees | 


rae eee 
| Condition Indication | 
i= Sacre eo eee enn N 
| System wait at location 


| 
| '0010'. AC displays value | contained a format error. 
[co SPRES®©-« I 
| | 
| | 
] a i i a a 
System wait at location RTPLOAD—computed sun 
*O010%. AC displays vaiue {checksun) of columns 
CFEFZY » of last HASP/RTP1130 card 


I 

I 

| 

| read does not 
l 

| computed. 

| 


System wait at location | 
*O0010*. AC displays vaiue j 
'FFFI'. I 
| 
| 


last card has 


required. 


Un a ee 


Figure 13. HASP/RTP1130 Loading Errors (RTPLCAD) 


LOCAL MESSAGE SUMMARY 


Condition Description { 


The last REP card read 


columns 73-74, 


This is not an error. 


the 2501 or 1442, 
operator action is 


————__--— ay 
Operator Action 

| Loading is terminated 

| permanently. Note that a 

| card is in error, and notify 
j system programmer or lead 

| operator. 


Loading may be resumed by 
pressing start on 1130 
console. Unpredictable 
results may occur. Best 
action is to note card in 
error and notify system 
programmer or lead operator. 


1-72 


i 

i 

| 
match value in| 
previously i 
| 

| 


The 
been read by 
and 


To commence HASP/RTP1130 

processing, press START on 
the card reader until ready;| 
then press START on the 1130 


console. { 
eacskien ener 


three-—character ‘'DMT* prefix and by the 
fact that they are printed in red if the 
red/black typewriter ribbon is installed. 


Messages that are printed on the console 
typewriter originate from the RSCS system Local messages (typed in black) are 
Or are generated by HASP/RTP1130, in listed in Figure 14 along with a detailed 
conjunction with the station operation. explanation of each message. 
Messages from RSCS may be identified by the 
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Fe en cern a a ESO Ee 
{ Message j Explanation/Action { 
aS ERC ENC nl SCAR IPRA Gc as RCA 6 a ATOR REAR DOT AEG Sc TSE TA ERE ATI SUG BTS REE LU ee | 
{| INTERVENTION REQUIRED CN Where xxxx is 1442, 2501, 1403, or 1132. This message | 
XXxXX indicates that the indicated device has gone from a ready | 


ec ec a ts aR en 


| 
| 
j to a "not ready" condition, usually because the device wasj 
| manually stopped or because the device requires operator | 
{| action (for example, cards or paper). The device should be| 
| serviced as required and made ready to continue operation.! 
| This message is issued whenever punch data is waiting to | 
| be punched on a system equipped with a combination 1442 

| Card Read Punch. If the 1442 is defined as a reader, it 
| 
1 
| 


PUNCH PROCESSOR WAITING 
FOR 1442 


must complete the read function before it can be defined 
as a punch. If the 1442 is defined as a punch, no further 
action (other than providing blank cards and making the 

| device ready) is necessary. 


a a a ce ce ar a NE ES a TE A A EN AI rm 


| 
i 
| 
| 
| 
| 
{ 
DATA SET NOT READY | This message is issued when the communications adapter | 
Signals HASP/RTP1130 that the attached telephone data set | 

is in a "not ready" condition. The program does not | 

attempt to use the communication adapter until a "ready" | 
| 

| 

| 

| 

| 

| 

{ 

l 

| 

| 


| 
| 
| 
| condition is detected. All other functions (card input, 

| typewriter, etc.) continue until they require the service 
{| of the data set. If the data set was made "not ready" 

| by manual intervention, operation may be resumed by 

| making it ready. 

| 


{| could cause the operator to restart the communications 
} line. In this event, the HASP/RTP1130 program must be 
| reloaded. 

SCA LOG xxxxxx00 | Indicates an unusual condition associated with the SCA i 
{ (Synchronous Communication Adapter). | 

a wwe Se Sn SE Sp a | 
COMMUNICATICN LINE | Issued when the HASP/RTP1130 program is initialized and i 
ESTABLISHED | when communications have been established with the RSCS | 
| machine. | 


| WHAT? | Response to any local command not recognized or accepted | 
{ {| by HASP/RTP1130. | 
|—___-_______--____-__---_--_____-____________-—___ -__--—-——__-—-—- | 
| OK! | Response to any local command recognized or accepted by | 
I | HASP/RTP1130. | 


a as a a a a a ces cane cel 


Figure 14. IBM 1130 Local Messages 


The RSCS virtual machine, through the use 
of an SML line driver operating in RJE 
mode, can perform the functions of a HASP 
or ASP type workstation. In this capacity, 


RSCS accepts job files that are either 
spooled to it by VM/370 virtual machines or 
received from RSCS supported remote 
stations. It then transmits the job files, 
via the SML line driver, to the remote 
batch systen for processing. Output, 


received from the remote system is directed 
to the real printer or punch of the host 
¥VM/370 system. 


CONFIGURATION SPECIFICATIONS 


Any of the System/370 Models 135, 135-3, 
138, 145, 145-3, 148, 155 II, 158, 165 II, 
and 168, with at least 240K of processor 
storage, a minimum of two direct access 
storage devices, and equipped with a 
transmission control unit Supported by 
RSCS, can be used aS a remote job entry 
station to access a HASP or ASP type remote 
batch processor. The supported 
transmission control units are: 


e Integrated Communications Adapter (ICA) 
with Synchronous Data Adapter Type II on 
the System/370 Model 135 

e IBM 2701 Data Adapter Unit with 

Synchronous Data Adapter Type II 


e IBM 2703 Transmission Control Unit with 
Synchronous Terminal Control 

® IBM 3704 Communications Controller in 
emulation mode only 

e IBM 3705 Communications Conroller in 

emulation mode only 


SML AS THE REMOTE TERMINAL PROCESSOR 


—— ee oe ee we eee ee eee 


PROGRAM 


(RIP) 


In order for a system or device to function 
as a HASP or ASP type workstation, a Remote 
Terminal Processor (RTP) program must be 
loaded to provide the software functions of 
input, output, and communication according 
to the protocol established by the host 


batch processor. An SML line driver task, 
operating in RJE mode, provides these 
functions for RSCS when it is to act asa 


workstation for a remote batch system. 


RSCS as a Remote Job Entry Station 


INPUT FUNCTIONS 


The SML line driver, operating in RJE mode, 
provides the following input functions at 
the RSCS virtual machine: 


e Accesses job files received by RSCS from 
vM/370 virtual machines or remote 
stations. 


e Accepts HASP or ASP commands entered at 
the RSCS operator ccnsole. 


e compresses and blocks card images and 
commands into transmission records 
according to the protocol requirements 


of the receiving batch system. 


e fransmits the blocked records to the 
remote batch systen. 


OUTPUT FUNCTIONS 


The SML line driver, operating in RJE mode, 
provides the following output functions at 
the RSCS virtual machine: 


e Deblocks and decompresses transmission 
records received from the remote system. 


e Identifies the device required for 
output. 
e Spools the output to the real printer 


and/or punch. 


e Directs messages from the remote batch 
system to the RSCS operator's console. 


OPERATING PROCEDURES 


With the exception of the initialization 
and sign-on procedure, the operation of 
RSCS aS a HASP or ASP workstation is 
Similar to that described under the section 
"IBM System/370 as a Remote Station." 
Workstation procedures are also contained 


in the OS/WS2 HASP 


—S eee ee i ee ee ee Se 
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STARTING THE SML LINE DRIVER 


Once the RSCS virtual machine is logged on 
and the RSCS component is loaded, the RSCS 
operator can start the SML line driver. 


Issue the START command for the link to 


the remote batch systen. 


If the link attributes in the link table 
are appropriate for this session, the START 
command ca be issued as follows: 


r 1 
jHrn| 
START linkid Parm |Rrn| Bnnnn passwd 
{Arn| 
t J 
A description of the START command 
operands, including those that override 
previous definitions, can be found in the 
section "Starting SML" in "Part Zs 


Components of RSCS." 


The Hrn, Rrn, and Arn operands specify 
the type of remote batch system (HASP, RES, 
or ASP) and the workstation number or name 
that was assigned to RSCS at the time the 
remote system was generated. 


For HASP (or JES2), rn is a number fron 
1 through 99 and the entry could look like: 
H3, H20, or H43. 


For RES, rn is also a number fron 1 


through 99 and the entry could look like: 
For ASP, rn is a five alphameric 
character name and the entry could look 


like: ANEWYK, ABURLS5, APOK16, or A62121. 


The successful execution of the START 
command results in the following message: 


DMTSML141I LINE vaddr READY FOR CONNECTION 


TO LINK linkid 
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ESTABLISHING A COMMUNICATION LINE 


If the line identified by vaddr in the 
previous message is a nonswitched line, the 
line connection is automatically completed 
and the following message is issued: 


DMTSML142I LINK linkid LINE vaddr CONNECTED 


If the line is a switched line, the RSCS 
operator should perform the following: 
1. Press the TALK pushbutton, and lift 
the receiver off the data set. 
2. Dial the assigned number for the 
remote systen. 


3. If the line is available, the remote 
system answers with a high pitched 
tone. Press DATA and hang up 


immediately; the data set is now ready 
and the DMTSML142I message is issued. 


4. If the line 
is heard. 
dial an 
number. 


is in use, a busy signal 
Hang up and try later, or 
alternate communication line 


5. If the call is not answered, the 
remote system operator has not given 
the necessary command to authorize use 
of that communication line. Contact 
the remote system operator and request 
that he issue the appropriate START 
command for your workstation. 


When reguested by the 
SML line driver begins 
sequence. When 
complete, the 

performed. 


remote systen, the 
the initial control 
the initial sequence is 
sign-on procedure is 


SIGNING ONTO THE REMOTE SYSTEM 


builds a SIGNON record 
from the information contained in the RSCS 
START command. This record is then 
transmitted to the remote system for 
validation. When accepted, the SML line 
driver "handshakes" with the remote system 
until processing of job streams and output 
data actually begins. 


The SML line driver 


Appendixes 


e Appendix A: Remote Spooling Communications Subsystem 
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Appendix A: Remote Spooling Communications Subsystem Commands 


NOTATIONAL CONVENTIONS 


The notation used to define the command syntax in this publication is 
described in the following paragraphs: 


1. 


Truncations and Abbreviations of Commands 


Where truncation of a command name is permitted, the shortest 
acceptable version of the command is represented by uppercase 
letters. (Remember, however, that VM/370 commands can be entered 
with any combination of upper and lowercase letters.) The example 
below shows the format specification for the BACKSPAC command. 


BAckspac 


This representation means that BA, BAC, BACK, BACKS, BACKSP, 
BACKSPA, and BACKSPAC are all valid specifications for this command 
name. 


Operands and options are specified in the same manner. Where 
truncation is permitted, the shortest acceptable version of the 
operand or option is represented by uppercase letters in the 
command format box. If no minimum truncation is noted, the entire 
word (represented by all capital letters) must be entered. 


Abbreviations are shorter forms of command names, operands, and 
options. Abbreviations for command names are shown below the full 
name in the format box. Abbreviations for operands and options are 
shown in the description of the individual operands and options 
that follows the format box. For example, the operand READER has 
both a minimum truncation and an abbreviation. In the format box 
it is shown as: 


Reader 


indicating that the minimum truncation is R. In the discussion of 
the READER operand that follows, it is shown as: 


READER 
RDR 


indicating that the abbreviation is’ RDR. Thus, the acceptable 
specifications for the READER operand are: R, RE, REA, READ, READE, 
READER, and RDR. 


In some cases what appears to be a minimum truncation is really the 
only valid abbreviation. For example, the abbreviation for MEMBER 
is MEM. Only these two forms are valid and no truncations are 
allowed. The format box contains 


MEMBER aan 
* 


and the description that follows the format box is 


MEMBER {name 
MEM * 
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92 


The following symbols are used to define the command format and 
should never be typed when the actual command is entered. 


underscore 

braces { 
brackets E 
ellipsis 7 


fe ne ee Gesu =—we uy Geaause veo eV Rw Oe 


percase letters and words, and the folloving symbols should he 
tered as specified in the format box. 

asterisk * 

comma P 

hyphen = 

equal sign = 

parentheses () 

period : 

colon 


Lowercase letters, words, and symbols that appear in the command 
format box represent variables for which specific information 
should be substituted. For example; in the BACKSPAC command, 
linkid represents a variable link identifier such as BURLNGTN, 
CAMBRDGE, or HOUSTON. 


Choices are represented in the command format boxes by stacking. 


A 
B 
Cc 


An underscore indicates an assumed default option. If an 
underscored choice is selected, it need not be specified when the 
command is entered. 


a ns 


The representation 


Q loo be 


indicates that either A, B, or C may be selected. However, if B is 
selected, it need not be specified. Or, if none is entered, B is 
assumed. 


The use of braces denotes choices, one of which must be selected. 


indicates that you must specify either A, or B, or C. If a list of 
choices is enclosed by neither brackets nor braces, it is to be 
treated as if enclosed by braces. 
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ttf 


8. The use of brackets denotes choices, one of which may be selected. 


Example 
The representation 


indicates that you may enter A, or B, or C, or you may omit the 
field. 


9. An ellipsis indicates that the preceding item or group of items may 
be repeated more than once in succession. 


Example 
The representation 


(options...) 


indicates that more than one option may be codea within the 
parentheses. 


GENERAL COMMAND USAGE 


—_——— ee Se ee wwe See ee ee 


The RSCS commands described below can be issued by either the RSCS 
operator or the remote station operator with the following exceptions: 


e CMD, DEFINE, DELETE, DISCONN, and TRACE can be issued only by the 
RSCS operator. 


e START has limited capabilities when issued by a remote. station 
operator (see command description). 


e Commands, issued by a remote station operator, affect only the status 
of that station's link. With the exception of the MSG and the QUERY 
command, the linkid operand must not be specified in a remote staticn 
command line. 


File attributes which are those of the VM/370 spool system, and the 
operands describing them in the RSCS command language, have maximum 
values and default values identical to those of the VM/370 command 
language and system. Command names and keywords may be specified by 
typing any part of the command name or keyword from the minimum 
truncation to the full name. The minimum truncation in each case is 
indicated by uppercase letters. 


RSCS COMMANDS 


This section describes the commands used in the RSCS environment. 
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BACKSPAC 


The BACKSPAC command causes the current file teing processed to be 
restarted or repositioned backward. The format of the BACKSPAC command 
is: 


ao a o> a a + 

i ; Po r 1 | 

| BAckspac | [Llinkid] | File | | 

I | | nnn | | 

| | t . | 

a a ns a ca mm a 

where: 

linkid is the 1- to 8-character link identifier for the link on 
which the current file being processed is to be 
repositioned. If the command is issued by the RSCS 
operator, this operand must be specified; if issued from 
a remote station, it must be omitted. 

FILE is a keyword which specifies that the file being 
processed is to be restarted from the beginning. 

nnn is the number of data units to be backspaced. For a 


print file, data unit refers to printer pages, which are 
counted in the same way as for the analagous VM/370 
spooling command. For a punch file, data unit refers to 
file records which include any write type command code. 
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st 


CHANGE 


The CHANGE command alters one or more attributes of a spool file owned 
by the command originator. In order to affect a file using the CHANGE 
command, the file must be inactive (that is, no link may be actively 
processing it). The format for the CHANGE command is: 


{10ne of these operands must be chosen; however, more than one may 
| be specified. They may be combined in any order except for NAME, 
{| which, if specified, must be the last entry in the command line. 


a a a a ag 
I a| 

{| CHange i{ linkid] spoolid PRIority nn | 
| | CLass Cc { 
I l Copy nn | 
I | ¢ 1 
| I {Hold | | 
| | |Nohold| | 
| | L 4 
| | DIst distcode | 
| | Name (fn [ft] | 
j | \ vere \ | 
| 

| 

\ 

| 


Lt ne | 
where: 
linkid is the 1- to 8-character link identifier for the link on 


which the file to be changed is enqueuved. If the command 
is issued by the RSCS operator, this operand must be 
specified; if issued from a remote station, it must be 
omitted. 


spoolid is the numeric spool file identifier for the file which 
is to be changed. 


PRIORITY nn designates the new transmission priority for the file. 
nn is a decimal number from 0-99 with 0 signifying the 
highest priority. 


CLASS c designates the new class for the file. c is a 
1-character alphameric fieid from A to Z or from 0-39. 


COPY nn alters the number of copies to be made of the file. The 
value of nn (number of copies) must be a number from 1 
through 99. For nn less than 10, the leading zero is 
optional. 


HOLD prevents the processing of the file until it is released 
by a CHANGE command specifying NOHOLD. 


NOHOLD releases the specified spool file if it had been in HOLD 
status. 


DIST distcode changes the distribution code of the specified fiie. 
distcode is a 1- to S8-character identification to he 
associated with the file. 


NAME fn (ft) changes the name of the specified file. If specified, 
NAME dsname this operand must be the last entry in the command line. 
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For RSCS Operator Only 


The CMD command is available only to the RSCS operator. Used with the 
LOG and NOLOG keywords, it controls the logging of I/O activity ona 
specified link. When issued with a text operand, it passes the text 
data to the line driver for the specified link. The latter is available 
only when RSCS is functioning as a remote job entry station, and 
provides a mechanism by which the operator can exercise allowable 
control over functions performed by a remote system. The format of the 
CMD command is: 


ES St SE ST 


ai ae i ae i 
| CMD | linkid text | 
LOG | 


NOLOG | 
Sa i a a a se 


linkid is the 1- to 8-byte link identifier of the link whose 
active line driver is to receive the specified text line 
or whose line I/O activity is to be logged. 


text is an arbitrary string of alphameric characters 
comprising the text line to be presented to the specified 
link's line driver. The maximum length of the character 
string is 120 characters. (Format requirements for this 
string are dependent on the type of remote system implied 
by linkid.) 


LOG is the keyword that starts the logging of I/O activity on 
the link. 


NOLOG is the keyword that stops the logging of I/O activity and 
initiates the automatic printout of the log data. This 
same function also occurs when the DRAIN command is 
issued for a link that has Ivo logging in effect. 
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AE tin, 


DEFINE 


The DEFINE command causes a new link to be temporarily added to the set 
of valid links for the local RSCS installation, or causes an existing 
inactive link definition to be temporarily redefined. Permanent link 
definitions and changes can only be made as part of the _ system 
generation procedure. Files addressed to the remote station whose 
location ID is identical to the link ID may be processed after the link 
has teen defined. 


Note: In order to temporarily add new links via the DEFINE command, 


blank link definitions (GENLINK macro entries) must have been specified 
when the RSCS system was generated. 


oe a nn ee ee 


| 


| 

| linkid CLass c i 
| KEEP holdslot 

| LINE vaddr 

| TASK name 

| TYPE driverid 

| 


10ne of these operands must be specified; however, more than one may 
! be entered. 
cnr ct rr ce ee en ce ere a cs ee a a eee ane ee 


where: 

linkid is the 1- to 8-character link identifier for the new link 
to be defined, or for the existing link to he redefined. 

CLASS c Specifies the ciasses of files that may he processed by 


the active link. c can be either an asterisk (*), 
meaning that all file classes may be processed, or from 
one to four file classes (single characters with no 
intervening blanks). If no classes are specified, the 
default is *. 


KEEP holdslot specifies the number of virtual storage file tag slots to 
be reserved for exclusive use hy the link being defined. 
holdslot is a decimal number from 0 to 16. If the KEEP 
parameter is omitted, a default value of two is assumed. 


LINE vaddr designates the virtual device address (vaddr) of a 
permanent telecommunications port to be used for 
processing files for the affected link. If this 
parameter is omitted, the LINE definition defaults to 
undefined. 


TASK name designates a task name for use by the line driver 
associated with the link. name is a 1- to 4-character 
alphameric identifier. If this parameter is omitted, the 
task definition defaults to undefined. 


TYPE driverid designates the name of the line driver which is to be 
associated with the link. driverid is a 1- to 
8-character name of the line driver to be used (DMTNPT or 
DMTSML). The proper line driver to use with the link 
depends on the type of remote telecommunications system 
involved. If a new link is being defined, this operand 
must be specified or an error condition is indicated. 
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DELETE 


For RSCS Operator Only 
The DELETE command causes a previously defined link to become 
temporarily undefined. Permanent deletion of a link can only be made as 
part of the system generation procedure. The link to be deleted must be 
inactive and must have no files enqueued or pending at the time the 
DELETE command is issued. Files addressed to an undefined link are 
rejected as invalidly addressed. 


EA EE LE SS TL ET LL LIE at 


| DELete | linkid | 

a a a re a ne a a eee ee ee eee 

where: 

linkid is the 1- to 8-byte link identifier for the link that is 
to be undefined. 

DISCONN 


The CLISCONN command causes the RSCS operator console to be disconnected 
from the VM/370 system while RSCS continues to operate. The RSCS 
DISCONN command operates the same as the VM/370 DISCONN command, except 
that another userid may be specified to receive all RSCS' operator 
console output lines. If no userid is specified, the RSCS console 
output lines are discarded without being printed. In order for the RSCS 
operator to reconnect his console, he must log onto the system again. 
The format of the DISCONN command is: 


De fn edo EB ay eS SE ETO a eg Ra ae ae FP OR Pt TP RSE GO Levey we pp eT POEs Gg ap ee Tee cy aire PANE GRAF OA, go ee my ee ee St Le 

| DISConn | { userid Jj | 

aS ey 

where: 

userid is the 1- to 8-character ID for the virtual machine that 
is to receive subsequent RSCS operator console output 
lines. 
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Rn. 


DRAIN 


The DRAIN command causes the specified link to be deactivated after the 
file currently being processed is completed. The link is deactivated 
immediately if no file is being processed when the DRAIN command is 
issued. An inactive link is activated by a START command. If a START 
command is issued for the link before final file processing is complete, 
the link is not deactivated and normal processing is continued. 


Note: If the specified link has I/O logging in effect, it is terminated 
and the automatic printout of the log data is initiated. 


The format for the DRAIN command is: 


Cas a ee ade ae gt Sag ee ae eta on Gloag ee ae eee ae a oe 
| DRain { [{ilinkid] | 
Be a ae oe Se Sel eS ee 
where: 

linkid is the 1- to 8-character link identifier for the link 


that is to be deactivated. If the command is issued by 
the RSCS operator, this operand must be specified; if 
issued from a remote station, it must be omitted. 
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FLUSH 


The FLUSH command causes file processing to be halted for the file which 
is currently being processed on a link. The file is either purged or 
held, and link processing continues with the next file that is enqueued 
for transmission on the link. The format for the PLUSH command is: 


ee) 


1 | 
[linkid] |spoolid| { ALL] [Old] | 

* | 
| 


a ct a ee te wn ms ns ecm vi m-mec i ee pec” mr sm eich mse in nap -ce- wuss enamel 


re_——4 


linkid is the 1- to 8-character link identifier for the link on 
which the file to be FLUSHed is being processed. If the 
command is issued by the RSCS operator, this operand must 
be specified; if issued from a remote station, it must be 
omitted. 


spoolid is the numeric spool file identifier for the file that is 
to be flushed. This field is provided to assure that an 
operator does not inadvertently destroy the wrong file 
through a timing error. 


* the asterisk character (*) specifies that the current 
file being processed is to be flushed. 


Note: This option is only available to the remote 
operator. 


ALL is a keyword which Signifies that all copies of the file 
being processed are to be deleted. If this option is not 
specified, only the current copy is deleted and the next 
copy, if any, is processed. 


HOld is a keyword which specifies that the file being 
processed is not to be purged, but rather is to be saved 
and placed in system hold status. Processing of the file 
may be restarted after the file has been taken out of 
hold status by means of the CHANGE command. 
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FREE 


The FREE command causes file transmission for a particular lin to be 
resumed. The hold status for each of the files enqueued on the link is 
not affected. The FREE command has no effect on a link for which file 
transmission had not previously been suspended through the use of the 
HOLD command. The format for the FREE command is: 


Ge ee ee ee ee ee ge ee a ee ga ee ee 
| FRee | (linkid] I 
[re | 
where: 

linkid is the 1- to 8-character link identifier for the link on 


which file transmission is to be resumed. If the command 
is issued by the RSCS operator, this operand must be 
specified; if issued from a remote station, it must be 
omitted. 


FWDSPACE 


The FWDSPACE command causes the current file being processed to be 
repositioned forward. The format of the FWDSPACE command is: 


co - 


| FWdspace ! ([linkid] [{ nnn J] | 


where: 

linkid is the 1— to 8-character link identifier for which the 
current file being processed is to be repositioned. If 
the command is issued by the RSCE operator, this operand 
must be specified; if issued from a remote staticn, it 
must be omitted. 

nnn is the number of data units to be forward spaced (if none 


is specified, a default of 1 is assumed). For a print 
file, data unit refers to printer pages, Which are 
counted in the same way as for the VM/370 EACKSPAC 
command. For a punch file, data unit refers to file 
records that include any write type command code. If non 
is greater than the number of data units remaining to be 
processed, the command functions as a FLUSH command. 
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HOLD 


The HOLD command causes file transmission for a particular link to be 
temporarily suspended, without deactivating the link. File transmission 
is suspended when the currently active file is completed, or, 
optionally, file transmission may be suspended immediately, and resumed 
from that point at a later time. The HOLD command does not affect the 
hold status of any file enqueued for transmission on the link. File 
transmission for the link may be resumed by means of the FREE command. 
The format of the HOLD command is: 


SSS ee ee ee eee 
| Hold | [linkid] IMMED | 
| rn | 
where: 

linkid is the 1- to 8-character link identifier of the link for 


which file transmission is to be suspended. If the 
command is issued by the RSCS operator, this operand must 
be specified; if issued from a remote station, it must be 
omitted. 


IMMED is a keyword which specifies that active file 
transmission, if any, is to be suspended immediately. 


MSG 


The MSG command causes the message text typed by the operator, or 
entered via the card reader at a remote station, to be made available to 
the line driver for the specified link or to RSCS itself. The 
difference between the MSG command and the CMD command is that the 
variable text entered by the operator is a message tO an operator or 
user in the former case, and can be a remote system command in the 
latter case. The format of the MSG command is: 


aoe a Gy Pe Tt CAS on tig ee ey Fees fe eh ay Pe, ety oe Ge ey eae Sy oa R boat gan 


| Msg | linkid [userid] msgtext | 
| a a ee ee | 
where: 

linkid is the 1—~ to 8—character link identifier of the link 


whose active line driver is to receive the specified text 
line. If the message is for a lecal VM/370 user or for 
the RSCS operator, this operand is specified as the 
location identifier of the RSCS virtual machine. 


userid is the 1 to 8-character user identification of the 
virtual machine that is to receive the message. This 
Operand must be specified if the message is destined for 
a local VM/370 user or the RSCS operator. It should be 
omitted if the message is being sent to a_ remote 
location. When the message is teing sent to the RSCS 
Operator, the userid may be "*" or "RSCS." 


msgtext is an arbitrary string of alphameric characters 
comprising the text line to be presented to the specified 
link's line driver. The maximum length of the character 
string is 120 characters. 


ORDER 


The ORDER command causes the file queve for a particular link to be 
reordered as specified. The effect of the command is to redefine the 
order in which particular files are to be processed on the link. The 
specified files are placed at the start of the link queue in the 
specified order, and the file priority attribute is automatically set to 
zero {top priority) for each specified file. The format of the ORDER 
command is: 


We ep a hg ee ce ee mre ae eT Ne Oe eee ae A eA Tue PT eT Tee py eee nde Pea ge 

i ORDer | {ilinkid] {spoolid1 [ spoolid2 ... J} | 

a a ne ne nr ne ne ee er ee een en eran 

where: 

linkid is the 1 to 8-byte link identifier for the link on which 
the file queue is to be reordered. If the command is 


issued by the RSCS operator, this operand must be 
specified; if issued from a remote station, it must be 
omitted. 


spoolid1 [spoolid 2 ...] 
specifies the affected files, and defines the new order 
in which they are to be enqueued. 


PURGE 


The PURGE command causes specified inactive files for a particular link 
to be removed from the system before they are processed on the link. 
Any file may be purged, regardless of its status, as long as it has not 
been selected for processing. The format of the PURGE command is: 


Go tea wn aN, Soe, phe a ee eee Soo! Gee Ci Soe Spice owas ave A gles eal ae ak aged ca Tk oS uel a sgt Sos ay A OE 
| PURGe ! f{linkid] { ALL ) i 
| | spoolid1 [spoolid2 ...] { I 
| a i Sa a i a tn eS ae ew Se te Sap Sc ep pn i a Sp a ao ee ee a eel 
where: 

linkid is the 1- to 8-byte link identifier for the link on which 


the files to be removed are enqueued. If the command is 
issued by the RSCS operator, this operand must _ be 
specified; if issued from a remote station, it must be 
omitted. 


ALL specifies that the entire queve of files for the link is 
to be removed from the system. 


spoolid1 [spoolid2 ...] 


specifies the particular file(s) to be removed from the 
systen. 
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QUERY 


The QUERY command is used to display linkid, file, or system status 
information. If the command is issued by the RSCS operator, the 
response is directed to the RSCS virtual machine console. If the 
command is issued by a remote operator, the response is printed on the 
remote station printer. 


For the information returned by each option of the 
to the appropriate message text in "Appendix B: RS 
The format of the QUERY command is: 


QUERY command, refer 
CS Message Summary." 


Se a ee em ee ee Set 
Query 


SY¥stem [ Active ] 


 sainemmnanent 


| Note: Only one item, a linkid, a file, or the system, may be queried 
{ at any one time, and only one keyword may be specified. 
a i ah ee ee eee ee ee eed 


| | cr 4 | 
| | | Stat | | 
| | linkid | Def { | 
| | | Queue | | 
| | . 2 | 
{ | | 
{ | r 4 | 
| | | Stat | | 
| | File spoolid | RSCS | | 
{ | | Va | | 
{ l . _ | 
| | | 
\ | { 
| | 

| 

l 


where: 

linkid STAT requests information pertaining to the active 
attributes and status of the link specified by the 1- 
to 8-character linkid. (See the text of messages 
DMTCMX651I and DMTCMX6521.) 

linkid DEF requests informgation pertaining to the defined default 
attributes of the link specified by the 1- to 
8-character linkid. (See the text of message 
DMTCMX6531.) 

linkid QUEUE requests a list of brief descriptions of each file 


enqueued for transmission, in the current queue order, 
on the link specified by the 1- to 8- character 
linkid. (See the texts of messages DMTCMX654I and 
DMTCMX655I1.) 


FILE spoolid STAT requests certain information pertaining to the 
particular file that is specified by the numeric 
spoolid. (See the texts of messages DMTCMX660I and 
DMTCMX661L.) 


FILE spoolid RSCS requests a description of the RSCS control related 
attributes and status of the file specified by 
spoolid. (See the text of message DMTCMX6621.) 


FILE spoolid VM requests a description of the VM/370 spool system 
related attributes of the file specified by spoolid. 
(See the text of message DMTCMX663I.) 


citi Has 


SYSTEM 


ACTIVE 


requests brief descriptions of each link currently 
defined in the systen. (See the texts of messages 
DMTCMX670I, DMTICMX6711, DMTCMX672I, and DMTCMX6731.) 


is a qualifier used with the SYSTEM keyword to request 
that only information pertaining to active links is to 
be listed. 
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START 


The START command, issued by the RSCS operator, can cause a specified 
inactive link to be activated. It can also be used by either the RSCS 
or remote Operator to cause a particular active link to begin processing 
files of a specified set of classes or to reset a pending deactivation 


due to a DRAIN 


command. The format of the START command is: 


et cg aa ee eT Oe Ge Re ey a Pa en gee gee Opp age Oe ye RS ap ERT In OTT ES we ee ee ee 
| rc 
STArt | {linkid] | CLass c | {[ Parm ... J 
| | LINE vaddr | 
| | TASK nane | 
| | TYPE driverid | 
| u J 


where: 


linkid 


CLASS c 


LINE vaddr 


TASK name 


“Note: Any combination of keywords with assorted options may be 
entered in any order, except that the Parm keyword must be the 
is ahcag sh keyword if it is entered. 


Se | 


is the 1- to 8-character link identifier for the inactive 
link to be activated, or for the active link on which 
file processing is to be altered. If the command is 
issued by the RSCS operator, this operand must be 
specified; if issued from a remote station, it must be 
omitted. 


specifies classes of files which may be processed 
subsequent to the command execution. c can be either an 
asterisk (*), meaning that all file classes may be 
processed, or from one to four file classes (single 
characters with no intervening blanks). If * is 
specified, no other classes may be specified. If 
multiple classes are specified for a link, files are 
processed in the order that the classes were specified, 
and in priority order within each particular class. If * 
is specified, files are processed in priority sequence 
only. If no classes are specified, the definition cf 
CLASS in the link's link table is used. 


designates the virtual device address (vaddr) of the line 
port that is to be used by the newly activated link. The 
value specified overrides a device address that may have 
been previously defined for the link. If no line port 
address is specified, the previously defined address is 
used. If no address was previously defined and no 
address is specified, an available switched port is 
selected for use, and the operator is informed of that 
selection. This keyword option is valid only when 
activating an active link. 


designates a task name for use by the line driver to be 
initialized, that overrides the name that may have been 
previously defined for the link. name is a 11- to 
4-character alphameric identifier. If this field is not 
specified, the name previously defined for the link is 
used. If no name was previously defined for the link, an 
appropriate descriptive default task name is generated 
and used. This keyword option is valid cnly when 
activating an active link. 
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Ait, 


TYPE 


PARM 


driverid designates the name of the line driver that is to be used 


for the link to be activated. driverid is a 1- to 
8-character name cf the line driver to be used with the 
newly activated link and must have teen defined during 
RSCS generation. This keyword option is valid only when 
activating an active link. The line drivers’ supplied 
with RSCS are DMINPT for nonprogrammable terminals and 
DMTSML for spool MULTI-LEAVING stations. This 
specification overrides the driver name that may have 
been previously defined for the iink. 


Note: If no driver was previously defined for the link, 
this field mast be specified. 


is a keyword which causes the remainder of the command 
line to the right of the PARM keyword to be made 
available to the newly activated line driver. No further 
interpretation is performed on the command line after a 
PARM keyword is encountered, so it must always’ be the 
rightmost keyword to be specified. For a description of 
the PARM operands for each line driver, see "Starting 
NPT" and "Starting SML" in "Part 2. Components of RSCS." 
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For RSCS Operator Only 


The TRACE command causes the specified active link to report certain 
line activity information on the operator console, or to cease reporting 
such information. (See the description of the message DMTxxx149I in 
“Appendix B: RSCS Message Summary.") The purpose of this function is to 
provide operator assurance that the line service is functioning 
properiy. The format of the TRACE command is: 


ee mi oe er ee a wee re a ee a ee ee — 


| 
| 
| 
| 
| 
Only one keyword may be entered. If no keyword is entered, a default| 
of ALL is assumed. | 


Mn i i a in a i a ne a a ne ne ee eed 


where: 

linkid is the 1- to 8-byte link identifier of the link for which 
activity tracing is to be initiated or terminated. 

ALL is a keyword which specifies that the link's line driver 
is to report all line activity in a standard format. 

ERRORS is a keyword which specifies that the link's line driver 
is to report only line error events in a standard 
format. 

END is a keyword which specifies that the link's line driver 


is to cease reporting line activity. 
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satiate, 


GC20-1816-1 and -2, Page Modified by TNL GN25-0403, 


August 31, 


1977 
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RSCS messages are issued in response to However, when the message is issued, xxx is 
commands and spontaneously during systen replaced with the appropriate module code. 
execution. Messages issued in response to The next three characters contain the 
cormands are issued to the command message number. The last ‘character is a 
originator and, in certain cases, to the message severity code and consists of the 
RSCS local operator. Spontaneous messages following: 

are issued to the RSCS local operator 

whenever error or informational conditions R response messsage 

arise during system Operation. Certain I informational message 

spontaneous messages are issued to virtual E error message 

machine users when they apply to files 7 terminal error -- system shutdown 
originated or destined for the users. Ss severe error message 


The message codes listed conform to The key to the left of the message codes 
¥M/370 standards. The first three indicates the possible destinations of each 
characters (DMT) denote the RSCS component message; the column headings are as 
of VM/370. The next three characters denote follows: 
the module origin of each message; the 
possible codes are REX, CMX, AXS, INI, NPT, RSCS - RSCS local oferator's conscle 
and SML. Some messages can be issued by ORIG — Command originator 
more than one module. These messages VMID - Virtual machine user 
appear in the Summary with the fourth, CPOP — VM/370 CP operator 
fifth, and sixth characters encoded as xxx. 

RSCS SPONTANEOUS MESSAGES 


In ouNpD 


Pd Pd Pd Pd bd Pd DS bd 


Pd Pd Pd PS PS OS Pd OS OS Dd DS OS Dd DS 


p< 


pe P< 


IM HPO 


loo HH & < 


oc PS Pd PS 


IvoWwa 


RSCS Spontaneous Nessages 


DMTREXOOOL 
DMTCMXOO1IL 
DMTREXOO02I 
DMTCMXOO3I 
DMTxXxxO70E 
DMTREXOSCE 
DMTREXO90T 
DMTREXO91T 
DMTAXS1011I 
DMTAXS102I1 
DMTAXS103E 
DMTAXS104I 
DMTAXS105I 
DMTAXS1061 
DMTAXS1071 
DMTxxx108E 
DMTxXxx141I 
DMTxXxxx142I1 
DMTxxx1431I 
DMTxxx144TI 
DMTxxx 1451 
DMTXxXx 1461 
DMTXxx147I 
DMTXxx149I1 
DMTxXxXx160I 
DMTxxx170I 
DMTXxx190E 
DMTXxx934E 
DMTSML935E 
DMTNPT936E 


RSCS (VER v, LEV 1, mm/dd/yy) READY 

FREE STORAGE = nn PAGES 

LINK linkid DEACTIVATED 

LINK linkid EXECUTING: (command line text) 

I/O ERROR cuu SIOCC cc CSW csw SENSE sense CCW ccw 

PROGRAM CHECK —- LINK linkid CEACTIVATED 

PROGRAM CHECK IN SUPERVISOR -- RSCS SHUTDOWN 

INITIALIZATION FAILURE -~- RSCS SHOUTLOWN 

FILE spoolid ENQUEUED ON LINK linkid 

FILE spoolid PENDING FOR LINK linkid 

FILE spoolid REJECTED -- INVALIC CESTINATICN ADDRESS 

FILE SPOOLED TO userid2 -- ORG locid1 (name1) mm/dd/yy hh:mm:ss 
FILE spoolid PURGED 
FILE spoolid MISSING 
nn PENDING FILES FOR 
SYSTEM ERROR READING SPOOL FILE spoolid 

LINE vaddr READY FOR CONNECTION TO LINK linkid 

LINK linkid LINE vaddr CONNECTED 

LINK linkid LINE vaddr DISCONECTED 

RECEIVING: FILE FROM locid1 (name1) FOR locid2 (userid2) 
RECEIVED: FILE FROM locid1 (name1) FOR locid2 (userid2) 
SENDING: FILE spoolid ON LINK linkid, REC nnnnnon 

SENT: FILE spoolid ON LINK linkid 


-- DEQUEUED FROM LINK linkid 
LINK linkid MISSING 


LINK linkid LINE ACTIVITY: TCT= mmm; ERRS= nnn; TMOUTS= ppp 
LINE vaddr DISABLED FOR linkid 

FROM linkid: (MSG message text) 

INVALID SPOOL BLOCK FORMAT ON FILE spoolid 

ID CARD MISSING ON LINK linkid ~~ INPUT FILE PURGED 

LINK linkid IN RJE MODE -- PRINT FILE spoolid PURGED 

NO REMOTE PUNCH AVAILABLE ON LINK linkid —- FILE spoolid PURGED 
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nM AQ ums 
IA H WO 
(CO 4 ce <q 
lu OonmWwn 


Pa PS Od bd PS bd OM 
Pd Pd Pd PS PS Pd P< PS PS Pd PS OOS OM PS PG PS OS PS PS Dd DS 


os PS PS Od Od 


PS PS PS 


DMTCMX200I 
DMTCMX201E 
DMTCMX202E 
DMTCMX203E 
DMTCMX204E 
DMTCMX205E 
DMTCMX206E 
DMTCMX207E 
DMTCMX208E 
DMTCMX300I 
DMTCMX301E 
DMTCMX302E 
DMTCMX303E 
DMTCMX304E 


RSCS 


INVALID COMMAND command 
INVALID LINK linkid 

INVALID SPOOL FILE ID spoolid 
INVALID KEYWORD keyword 


CONFLICTING 


KEYWORD keyword 


INVALID OPTICN keyword option 


CONFLICTING 


OPTION keyword option 


INVALID USER ID userid 


ACCEPTED BY 
REJECTED BY 
LINK linkid 
LINK linkid 
REJECTED BY 


TASK task 


TASK task --— PREVIOUS COMMAND ACTIVE 
IS NOT DEFINED 


IS NOT ACTIVE 
TASK task —- NOT RECEIVING 


BACKSPAC: 


DMTxxx510L 
DMTXxx511E 


CHANGE: 


DMTAXS5201 
DMTAXS5211I 
DMTAXS5221 
DMTAXS5231 
DMTAXSS24UE 
DMTAXS525E 
DMTAXS526E 


CMD: 


DMTxxx5301 


DEFINE: 


DMTCMX540I 
DMTCMX5411 
DMTCMX542E 
DMTCMX543E 
DMTCMX544E 


DELETE: 


DMTCMX550I 
DMTCMX551E 
DMTCMX552E 


FILE spoolid BACKSPACED 
NO FILE ACTIVE ON LINK linkid 


FILE spoolid CHANGED 
FILE spoolid HELD FOR LINK linkid 
FILE spoolid RELEASED FOR LINK linkid 


LINK linkid 


FILE spoolid ACTIVE -- NO ACTION TAKEN 
FILE spoolid IS FOR LINK linkid -- NO ACTION TAKEN 
FILE spoolid NOT FOUND -- NO ACTION TAKEN 


QUEUE REORDEREL 


COMMAND FORWARDED ON LINK linkid 


NEW LINK linkid DEFINED 


LINK linkid 
LINK linkid 
LINK linkid 
LINK linkid 


LINK linkid 
LINK linkid 
LINK linkid 


REDEFINED 
ACTIVE -~- NOT RELEFINEL 
NOT DEFINED -— LINK LIMIT REACHED 


NOT DEFINED -- TYPE NOT SPECIFIED 


NOW DELETED 
ACTIVE -- NOT CELETEL 
HAS A FILE QUEUE —- NOT DELETED 


wm awn w 


~< >< 


bs bd Ps 


pd P< be 


IM HwWO 


PS pd D< 


pd Pd bd bd 


(to eH re 


rI9O WO 


Specific Command 


DISCONN: 


DMTCMX560I RSCS 


Responses 


DISCONNECTING 


DMTCMX561E USERID userid NOT RECEIVING 


DRAIN: 


DMTxxx570I LINK 
DMTxxx571E LINK 


FLUSH: 


DMTxxx580I FILE 
DMTxxx581E FILE 


FREE: 


DMTxxx5901 LINK 
DMTxxx591E LINK 


FWOSPACE: 


DMTxxx600I FILE 


linkid NOW SET TO DEACTIVATE 
linkid ALREADY SET TO DFACTIVATE 


spoolid PROCESSING TERMINATED 
spoolid NOT ACTIVE 


linkid RESUMING FILE TRANSFER 
linkid NOT IN HOLD STATUS 


spoolid FORWARD SPACED 


DMTxxx511E NO FILE ACTIVE ON LINK linkid 


HOLD: 
DMTxxx610I LINK 


DMTxxx611I LINK 
DMTxxx612E LINK 


MSG: 


No response. 


ORDER: 


DMTAXS5231I LINK 
DMTAXSS24HE FILE 
DMTAXS525E FILE 
DMTAXSS26E FILE 


linkid TO SUSPEND FILE TRANSMISSION 
linkid FILE TRANSMISSION SUSPENDED 
linkid ALREADY IN HOLD STATUS 


linkid QUEUE REORDERED 


spoolid ACTIVE -- NC ACTION TAKEN 
spoolid IS FOR LINK linkid -- NO ACTION TAKEN 
spoolid NOT FOUND -- NO ACTION TAKEN 
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IN QM w 
Top lo a) 


oS Pd PS pd 
P< DS P< bd 


bd od PS 


Db PS bd OS 


ted So 


nWmonmwn 


DMTAXS5S24E 
DMTAXS525E 
DMTAXS526E 
DMTAXS640I 


FILE spoolid ACTIVE -- NO ACTION TAKEN 

FILE spoolid IS FOR linkid -- NO ACTION TAKEN 
FILE spoolid NOT FOUND -- NO ACTION TAKEN 

nn FILE(S) PURGED ON LINK linkid 


QUERY linkid STAT: 


DMTCMX651I 
DMTCMX652I 


LINK linkid INACTIVE 
LINK linkid ACTIVE task type vaddr c {HO|NOH} {DR|NOD} 
{ TRA|TRE| NOT} Q=m P=n 


QUERY linkid DEF: 


DMTCMX653I1 


LINK linkid DEFAULT task type vaddr c R=m 


QUERY linkid QUEUE: 


DMTCMX654I 
DMTCMX655I 


QUERY FILE 
DMTCMX660I1 


DMTCMX661I 
DMTCMX664E 


QUERY FILE 
DMTCMX662I 


DMTCM X664E 


QUERY FILE 
DMTCMX663I1 


DMTCMX664E 


LINK linkid Q=m P=n 
FILE spoolid locid userid CL a PR mm REC nnnnnn {A[T} 


spoolid STAT: 


FILE spoolid INACTIVE ON LINK linkid 
FILE spoolid ACTIVE ON LINK linkid 
FILE spoolid NOT FOUND 


spoolid RSCS: 


FILE spoolid ORG locid1 userid! mm/dd/yy hh:mm:ss 
TO locid2 userid2 
FILE spoolid NCT FOUND 


spoolid VM: 


FILE spoolid PR mm CL a CO nn {HO|NOH} DI distcode, 
NA {fn ft{dsname} 
FILE spoolid NOT FOUND 


QUERY SYSTEM: 


DMTCMX670I 
DMTCMX671I 
DMTCMX672T 
DMTCMX6731 


LINK linkid ACTIVE -- LINE vaddr {HO|NOH} 
LINK linkid INACTIVE 

NO LINK ACTIVE 

NO LINK DEFINED 
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stl, 


DS bd bd b< bq P< ln A WN pw 


bd PS bd PS bd DS bd P< bd Dd 


DS pd Pd b< Dd 


pd OM bd Pd be OS Dd PC pe OS Dd 


IM HwO 


pd OS dD 


PC bd OS bd P< 


Io Hy me < 


Im OWT 


DMTCMX700I 
DMTCMX701E 
DMTCMX702E 


DMTCMX703E 
DMTCMX704E 
DMTCMX705E 


DMTCMX706E 
DMTCMX707E 
DMTCMX708E 
DMTCMX709E 
DMTCMX710E 
DMTxxx750E 
DMTCMX751I 
DMTxxx752I 
DMTSMLYOTE 
DMTSMLSO6E 


TRACE: 


DMTxxx801I 
DMTxxx802I 
DMT xxx8031 
DMTxxx810E 
DMTxxx811lE 


SIGNCN: 


DMTxxx902E 
DMTxxx903E 
DMTNPTSO4E 
DMTxxx905I 
DMTNPTIO7E 


DMTINI4O2T 
DMTIN 1406R 
DMTINI4O7R 
DMTINIUOOR 
DMTINI410R 
DMTINI4315S 
DMTINI479E 
DMTINI480E 
DMTINIYS8IE 
DMTINI482E 
DMTINI4S83E 


—_—-_——— 


ACTIVATING LINK linkid task type vaddr c 

NO SWITCHED LINE AVAILABLE -- LINK linkid NOT ACTIVATED 
LINE vaddr IS IN USE BY LINK linkid1 -- LINK linkid2 
NOT ACTIVATED 


DEV cuu IS NOT A LINE PORT -- LINK linkid NOT ACTIVATED 

LINE vaddr CC=3 NOT OPERATIONAL -- LINK linkid NOT ACTIVATED 
DRIVER type NOT FOUND ON DISK vaddr -- LINK linkid NOT 
ACTIVATED 

FATAL ERROR LOADING FROM vaddr -- LINK linkid NOT ACTIVATED 
DRIVER type FILE FORMAT INVALID -- LINK linkid NOT ACTIVATED 
VIRTUAL STORAGE CAPACITY EXCEEDED -- LINK linkid NOT ACTIVATED 
TASK NAME task ALREADY IN USE -- LINK linkid NOT ACTIVATED 
MAX (nn) ACTIVE -- LINK linkid NOT ACTIVATED 

LINK linkid ALREADY ACTIVE -- NO ACTION TAKEN 

LINK linkid ALREADY ACTIVE -- NEW CLASS(ES) SET AS REQUESTED 
LINK linkid STILL ACTIVE -- DRAIN STATUS RESET 

INVALID SML MODE SPECIFIED -- LINK linkid NOT ACTIVATED 
INVALID SML EFUFFER PARAMETER -~- LINK linkid NOT ACTIVATED 
LINK linkid ERROR TRACE STARTED 

LINK linkid TRACE STARTED 

LINK linkid TRACE ENDED 

LINK linkid TRACE ALREADY ACTIVE 

LINK linkid TRACE NOT ACTIVE 


NON-SIGNON CARD READ ON LINK linkid 
PASSWORD SUPPLIED ON LINK linkid IS INVALID 
SIGNON PARAMETER=parameter INVALID 

SIGNON of LINKID linkid COMPLETE 

SIGNON TYPE PARAMETER MISSING 


—_—K——ace et ee ea oe SS we ee eS ee 


IPL DEVICE READ I/O ERROR 
SYSTEM DISK ADDRESS = ccu 

REWRITE THE NUCLEUS? (YES{NO) 

NUCLEUS CYL ADDRESS = nan 

ALSO IPL CYLINDER 0? (YES]|NO) 

IPL DEVICE WRITE I/O ERROR 

INVALID DEVICE ADDRESS -- REENTER 

INVALID CYLINDER NUMBER -- REENTER 

INVALID REPLY -- ANSWER "YES" OR "NO" 
SYSTEM DISK ERROR -- REENTER 

NUCLEUS WILL OVERLAY CMS FILES -- RECOMPUTE 
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A 
(No entries) 


B 
BACKSPAC 
command response 110 
format 94 
NPT operator command 31 
RSCS operator command 22 
SML operator command 38 
Cc 
CHANGE 
command response 110 
format 95 
NPT operator command 31 
RSCS operator command 22 
SML operator command 38 
CMD 
command response 110 
format 96 


RSCS operator command 22 
CMS Batch Facility 

job accounting considerations 25 

remote job entry with RSCS 24 
command responses 

BACKSPAC 110 

CHANGE 110 

CMD 110 

DEFINE 110 

DELETE 110 

DISCONN 111 

DRAIN 111 

FLUSH 111 

FREE 111 

FWDSPACE 111 

general 110 

HOLD 111 

ORDER 111 

PURGE 112 

QUERY 112 

SIGNON 113 

specific 110 

START 113 

TRACE 113 
communication commands 

NPT remote operator 32 

RSCS operator 22 

SML remote operator 38 
components of RSCS 15 
configuration of RSCS 17 


D 

DEFINE 
command response 110 
format 97 


RSCS operator command 21 
DELETE 

command response 110 

format 98 

RSCS operator command 21 
DISCONN 

command response 111 

format 98 

RSCS operator command 23 
DRAIN 

command response 111 

format 99 

NPT operator command 31 

RSCS operator command 21 

SML operator command 37 


E 
entering commands 
IBM System/3 Model 10 74 
IBM System/360 58 
IBM System/360 Model 20 64 
IBM System/370 58 
IBM 1130 Systen 81 
IBM 2770 41 
IBM 2780 44 
IBM 2922 64 
IBM 3770 48 
IBM 3780 49 
error recovery 
communication adapter 
IBM System/360 58 
IBM System/360 Model 10 76 
IBM System/360 Model 20 65 
IBM System/370 58 
IBM 1130 System 82 
. IBM 2922 65 
receiving 
IBM 2770 43 
IBM 2780 46 
IBM 3770 48 
IBM 3780 50 
restart 
IBM System/3 Model 10 78 
IBM System/360 60 
IBM System/360 Model 20 67 
IBM System/370 60 
IBM 1130 System 84 
IBM 2922 67 
transmitting 
IBM 2770 42 
IBM 2780 45 
IBM 3770 48 
IBM 3780 50 


Index 


Index 
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unit record 
IBM System/3 Model 10 76 
IBM System/360 58 
IBM System/360 Model 20 66 
IBM System/370 58 
IBM 1130 System 83 
IBM 2922 66 


F 
files 
control commands 
NPT remote operator 31 
RSCS operator 22 
SML remote operator 38 
processing in RJE mode 36 
FLUSH 
command response 111 
format 100 
NPT operator command 31 
RSCS operator command 22 
SML operator command 38 
FREE 
command response 111 
format 101 
NPT operator command 31 
RSCS operator command 22 
SML operator command 37 
FWDSPACE 
command response 111 
format 101 
NPT operator command 31 
RSCS operator command 22 
SML operator command 38 


G 
general command responses 110 


H 
hardware support 
NPT line driver 27 
RSCS virtual machine 17 
SML line driver 33 
HOLD 
command response 111 
format 102 
NPT operator command 31 
RSCS operator command 22 
SML operator command 37 
HOST mode, Signing on to SML 36 


I 
IBM System/3 as a remote station 69 


IBM System/3 Model 10 as a remote station 


entering commands 74 

error recovery 
communication adapter 76 
restart 78 
unit record 76 

Operating procedures 71 

remote terminal processor program 
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70 


supported configuration 70 
terminating a session 76 


IBM System/32 as a remote station 69 
IBM System/360 as a remote station 


entering commands 58 
error recovery 

communication adapter 58 

restart 60 

unit record 58 
operating procedures 56 
remote terminal processor program 55 
supported configuration 55 
terminating a session 58 


IBM System/360 Model 20 as a remote station 


entering commands 64 
error recovery 

communication adapter 65 

restart 67 

unit record 66 
operating procedures 62 
remote terminal processor program 61 
supported configuration 61 
terminating a session 65 


IBM System/370 as a remote station 


entering commands 58 
error recovery 

communication adapter 58 

restart 60 

unit record 58 
operating procedures 56 
remote terminal processor program 55 
supported configuration 55 
terminating a session 58 


IBM 1130 System as a remcte station 


entering commands 81 
error recovery 

communication adapter 82 

restart 84 

unit record 83 
operating procedures 80 
remote terminal processor program 79 
supported configuration 79 
terminating a session 82 


IBM 2770 as a remote terminal 


entering commands 41 
error recovery 
receiving 43 
transmitting 42 
operational notes 41 
supported configuration 41 
terminating a session 41 


IBM 2780 as a remote terminal 


entering commands 44 
error recovery 
receiving 46 
transmitting 45 
operational notes 44 
supported configuration 44 
terminating a session 44 


IBM 2922 as a remote station 


entering commands 64 
error recovery 
communication adapter 65 
restart 67 
unit record 66 
operating procedures 62 
remote terminal processor program 61 
supported configuration 61 


Att i, 


terminating a session 65 
IBM 3770 as a remote terminal 
entering commands 48 
error recovery 
receiving 48 
transmitting 48 
Operational notes 47 
supported configuration 47 
terminating a session 48 
IBM 3780 as a remote terminal 
entering commands 49 
error recovery 
receiving 50 
transmitting 50. 
Operational notes 49 
Supported configuration 49 
terminating a session 49 
ID control card 
NPT 30 
SML in HOST mode 36 
initiating line drivers 24 
input file processing 
NPT 30 
SML in HOST mode 36 
input/output control 
NPT 28 
SML 34 
interface, VM/370 spool systen 
introduction to RSCS 39 
I/O logging 26 


K 
key to message distribution 


L 

line allocation 
NPT 28 
SML 35 


line control commands 
NPT remote operator 31 
RSCS operator 21 
SML remote operator 37 
link 
class 13 
definition 13 
line 13 
linkid 13 
table 13 
type 13 
link control commands 
NPT remote operator 31 
RSCS operator 21 
SML remote operator 37 


M 

messages 
NPT 32 
SML 38 

messages and responses 109 
general command 110 
key to distribution 108 
sign-on 113 


13 


109 


specific command 110 


spontaneous 109 
system generation 113 
system initialization 113 


miscellaneous commands 
NPT remote operator 32 
RSCS operator 23 
SML remote operator 38 
MSG 
format 102 
NPT operator command 32 
RSCS operator command 23 
SML operator command 38 


MULTI-LEAVING Remote Job Entry Work Station 


(MRJE/WS) Program 69 


N 
nonprogrammable remote terminals 39 
nonprogrammable terminal (see NPT) 


nonprogrammable terminal line driver 


notational conventions fcr RSCS commands 


91 

NPT line driver 
input file processing 30 
input/output control 28 
line allocation 28 
output file processing 30 
remote operator functions 27 
RSCS operator functions 27 
Signing on 29 
starting 28 
supported functions 27 
supported hardware 27 
VM/370 user functions 28 

NPT messages 32 

NPT operational notes 
IBM 2770 41 
IBM 2780 44 
IBM 3770 47 
IBM 3780 49 


NPT remote operator, commands, file control 


31 

NPT remote operator commands 
BACKSPAC 31 
CHANGE 31 
communication 32 
DRAIN 31 
FLUSH 31 
FREE 31 
FWDSPACE 31 
HOLD 31 
line control 31 
link control 31 
miscellaneous 32 


MSG 32 

ORDER 31 
PURGE 31 
QUERY 32 


START on active link 31 


0 

operating procedures 
IBM System/3 Model 10 71 
IBM System/360 56 


Index 
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IBM System/360 Model 20 62 

IBM System/370 56 

IBM 1130 System 80 

IBM 2922 62 

RSCS aS an RJE station 87 
ORDER 

command response 177 

format 103 

NPT operator command 31 

RSCS operator command 22 

SML operator command 38 
output file processing 

NPT 30 

SML in HOST mode 37 
Overview of RSCS 11 


P 
PURGE 
command response 112 
format 103 
NPT operator command 31 
RSCS operator command 22 
SML operator command 38 
Q 
QUERY 
command response 112 
format 104 
NPT operator command 32 
RSCS operator command 23 
SML operator command 38 
R 


remote, operator commands, SML in HOST mode 
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